extras/source/truetype/symbol/README

   1 Modify the OpenSymbol.sfd and generate opens___.ttf from it with FontForge. The
   2 .sfd is the canonical source for the .ttf. See .sfd format documentation at
   3 https://fontforge.org/docs/techref/sfdformat.html.
   4 Use TTX/FontTools, which can dump the content of .ttf as an XML file, in order
   5 to make sure that the resulting .ttf differs only deliberately from the original
   6 one.
   7
   8 Every new version of the font should increase the font version. This is
   9 important so that when two versions of the font are installed, e.g.  one
  10 bundled inside the office installation, and one already installed on the system
  11 that the most recent font can be detected and favoured.
  12
  13 Bumping the font version is easiest done manually by bumping the place in
  14 the .sfd where the version is mentioned, e.g.
  15
  16 -Version: 102.3
  17 +Version: 102.4
  18
  19 The glyph names in the font should follow Adobe Glyph list for new fonts
  20 (https://github.com/adobe-type-tools/agl-aglfn) or just the uniXXXX scheme
  21 (see https://github.com/adobe-type-tools/agl-specification for the rationale).
  22
  23 Fragments of OpenSymbol are mapped internally to a number of other
  24 fonts for interoperability purposes. See
  25 unotools/source/misc/fontcvt.cxx pwrt, the StarSymbol conversion
  26 tables.
  27
  28 Generate the ttf from updated sfd:
  29 fontforge -lang=ff -c 'Open($1); Generate($2)' extras/source/truetype/symbol/OpenSymbol.sfd opens___.ttf
  30
  31 Update opens___.ttf on TDF server:
  32 scp opens___.ttf libreoffice@dev-www.libreoffice.org:/srv/www/dev-www.libreoffice.org/extern/$(sha256sum opens___.ttf | awk '{ print $1 }')-opens___.ttf
  33
  34 Update sha256sums in source files like in this example commit:
  35 https://gerrit.libreoffice.org/#/c/75577/