Skip to content

Commit

Permalink
Minor adjustments and formatting tweaks
Browse files Browse the repository at this point in the history
  • Loading branch information
Ken Lunde committed Aug 21, 2019
1 parent 5de337b commit 0276763
Show file tree
Hide file tree
Showing 5 changed files with 26 additions and 32 deletions.
6 changes: 3 additions & 3 deletions LICENSE.txt → LICENSE.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,9 @@ Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

Neither the name of Adobe Systems Incorporated nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
Neither the name of Adobe nor the names of its contributors may be
used to endorse or promote products derived from this software without
specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
Expand Down
16 changes: 8 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,17 +4,17 @@ This open source project is intended to be coupled with the [AGL Specification](

## Contents

This project includes the following resources:
This project includes the following three resources:

*glyphlist.txt*: AGL
*aglfn.txt*: AGLFN
*zapfdingbats.txt*: ITC Zapf Dingbats Glyph List
* AGL (*glyphlist.txt*)
* AGLFN (*aglfn.txt*)
* ITC Zapf Dingbats Glyph List (*zapfdingbats.txt*)

## Overview

AGL (*Adobe Glyph List*) simply provides mappings from glyph names to Unicode scalar values.

AGLFN (*Adobe Glyph List For New Fonts*) provides a list of base glyph names that are recommended for new fonts, which are compatible with the [AGL (*Adobe Glyph List*) Specification](https://github.com/adobe-type-tools/agl-specification), and which should be used as described in Section 6 of that document. AGLFN comprises the set of glyph names from AGL that map via the AGL Specification rules to the semantically correct UV (*Unicode Value*). For example, "Asmall" is omitted because AGL maps this glyph name to the PUA (*Private Use Area*) value U+F761, rather than to the UV that maps from the glyph name "A." Also omitted is "ffi," because AGL maps this to the Alphabetic Presentation Forms value U+FB03, rather than decomposing it into the following sequence of three UVs: U+0066, U+0066, and U+0069. The name "arrowvertex" has been omitted because this glyph now has a real UV, and AGL is now incorrect in mapping it to the PUA value U+F8E6. If you do not find an appropriate name for your glyph in this list, then please refer to Section 6 of the AGL Specification.
AGLFN (*Adobe Glyph List For New Fonts*) provides a list of base glyph names that are recommended for new fonts, which are compatible with the [AGL (*Adobe Glyph List*) Specification](https://github.com/adobe-type-tools/agl-specification), and which should be used as described in Section 6 of that document. AGLFN comprises the set of glyph names from AGL that map via the AGL Specification rules to the semantically correct UV (*Unicode Value*). For example, 'Asmall' is omitted because AGL maps this glyph name to the PUA (*Private Use Area*) value U+F761, rather than to the UV that maps from the glyph name 'A'. Also omitted is 'ffi', because AGL maps this to the Alphabetic Presentation Forms value U+FB03, rather than decomposing it into the following sequence of three UVs: U+0066, U+0066, and U+0069. The name 'arrowvertex' has been omitted because this glyph now has a real UV, and AGL is now incorrect in mapping it to the PUA value U+F8E6. If you do not find an appropriate name for your glyph in this list, then please refer to Section 6 of the AGL Specification.

The *ITC Zapf Dingbats Glyph List* is similar to AGL in that it simply provides mappings from glyph names to Unicode scalar values, but only for glyphs in the ITC Zapf Dingbats font.

Expand All @@ -25,21 +25,21 @@ Each record in AGL (*glyphlist.txt*) and the *ITC Zapf Dingbats Glyph List* (*za
* Glyph name—*upper/lowercase letters and digits*
* Unicode scalar value—*four uppercase hexadecimal digits*

The AGL and *ITC Zapf Dingbats Glyph List* records are sorted by glyph name in increasing ASCII order, lines starting with "#" are comments, and blank lines should be ignored.
The AGL and *ITC Zapf Dingbats Glyph List* records are sorted by glyph name in increasing ASCII order, lines starting with '#' are comments, and blank lines should be ignored.

Each record in AGLFN (*aglfn.txt*) is comprised of three semicolon-delimited fields, described as follows:

* Standard UV or CUS (*Corporate Use Subarea*) UV—*four uppercase hexadecimal digits*
* Glyph name—*upper/lowercase letters and digits*
* Character names: Unicode character names for standard UVs, and descriptive names for CUS UVs—*uppercase letters, hyphen, and space*

The AGLFN records are sorted by glyph name in increasing ASCII order, entries with the same glyph name are sorted in decreasing priority order, the UVs and Unicode character names are provided for convenience, lines starting with "#" are comments, and blank lines should be ignored.
The AGLFN records are sorted by glyph name in increasing ASCII order, entries with the same glyph name are sorted in decreasing priority order, the UVs and Unicode character names are provided for convenience, lines starting with '#' are comments, and blank lines should be ignored.

## More Information

Important details about glyph naming and interpreting glyph names can be found in the [AGL Specification](https://github.com/adobe-type-tools/agl-specification), which is an open specification.

The tools and documentation that comprise [AFDKO (*Adobe Font Development Kit for OpenType*)](http://www.adobe.com/devnet/opentype/afdko.html) are helpful for those who develop OpenType fonts. For general and format-related questions about OpenType fonts, the [OpenType Specification](http://www.microsoft.com/typography/otspec/) is the single best source.
The tools and documentation that comprise [AFDKO (*Adobe Font Development Kit for OpenType*)](https://github.com/adobe-type-tools/afdko/) are helpful for those who develop OpenType fonts. For general and format-related questions about OpenType fonts, the [OpenType Specification](https://docs.microsoft.com/en-us/typography/opentype/spec/) is the single best source.

## Getting Involved

Expand Down
12 changes: 5 additions & 7 deletions aglfn.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
# -----------------------------------------------------------
# Copyright 2002, 2003, 2005, 2006, 2008, 2010, 2015 Adobe Systems
# Incorporated. All rights reserved.
# Copyright 2002-2019 Adobe (http://www.adobe.com/).
#
# Redistribution and use in source and binary forms, with or
# without modification, are permitted provided that the
Expand All @@ -15,10 +14,9 @@
# disclaimer in the documentation and/or other materials
# provided with the distribution.
#
# Neither the name of Adobe Systems Incorporated nor the names
# of its contributors may be used to endorse or promote
# products derived from this software without specific prior
# written permission.
# Neither the name of Adobe nor the names of its contributors
# may be used to endorse or promote products derived from this
# software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
# CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
Expand Down Expand Up @@ -694,4 +692,4 @@
017C;zdotaccent;LATIN SMALL LETTER Z WITH DOT ABOVE
0030;zero;DIGIT ZERO
03B6;zeta;GREEK SMALL LETTER ZETA
#END
# END
12 changes: 5 additions & 7 deletions glyphlist.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
# -----------------------------------------------------------
# Copyright 2002, 2010, 2015 Adobe Systems Incorporated.
# All rights reserved.
# Copyright 2002-2019 Adobe (http://www.adobe.com/).
#
# Redistribution and use in source and binary forms, with or
# without modification, are permitted provided that the
Expand All @@ -15,10 +14,9 @@
# disclaimer in the documentation and/or other materials
# provided with the distribution.
#
# Neither the name of Adobe Systems Incorporated nor the names
# of its contributors may be used to endorse or promote
# products derived from this software without specific prior
# written permission.
# Neither the name of Adobe nor the names of its contributors
# may be used to endorse or promote products derived from this
# software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
# CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
Expand Down Expand Up @@ -4324,4 +4322,4 @@ zretroflexhook;0290
zstroke;01B6
zuhiragana;305A
zukatakana;30BA
#END
# END
12 changes: 5 additions & 7 deletions zapfdingbats.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
# -----------------------------------------------------------
# Copyright 2002, 2010, 2015 Adobe Systems Incorporated.
# All rights reserved.
# Copyright 2002-2019 Adobe (http://www.adobe.com/).
#
# Redistribution and use in source and binary forms, with or
# without modification, are permitted provided that the
Expand All @@ -15,10 +14,9 @@
# disclaimer in the documentation and/or other materials
# provided with the distribution.
#
# Neither the name of Adobe Systems Incorporated nor the names
# of its contributors may be used to endorse or promote
# products derived from this software without specific prior
# written permission.
# Neither the name of Adobe nor the names of its contributors
# may be used to endorse or promote products derived from this
# software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
# CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
Expand Down Expand Up @@ -244,4 +242,4 @@ a97;275B
a98;275C
a99;275D
a9;2720
#END
# END

3 comments on commit 0276763

@mfwitten
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seriously, Ken?

@kenlunde
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, seriously. I already explained that I wasn't accepting your line-breaking changes, but I went ahead and changed the double quotes to single quotes, which resulted in placing the closing single quote before the punctuation. I also converted the three-element list to three bullets. I used the opportunity to make other editorial tweaks that were already in the pipeline.

@mfwitten
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You're welcome.

Please sign in to comment.