[Groff] [Heirloom] Generating doc/ files

[Pierre-Jean]

Hello alls,

I'm forwarding this discussion to the list. Comments are
welcome :)

Carsten Kunze wrote:

> on generating the documents under doc/just, doc/troff etc.
> a lot of errors regarding missing fonts are reported.  I
> had always ignored these messages.  I think that Gunnar
> had a lot more fonts installed on his private system to
> make the documents look fancy but did not put this fonst
> to SourceForge (maybe for licence reasons).  What do you
> think?  The question is regarding issue #1 on GitHub
> (https://github.com/n-t-roff/heirloom-doctools/issues/1).

Yes, Gunnar was using a set of special fonts:
- Adobe Myriad Pro for doc/quickstart,
- Adobe Garamond Premier Pro for doc/font and doc/just,
- Tex Gyre Terms OpenType for doc/troff,

Tex Gyre Terms OpenType can be downloaded from the CTAN:
http://www.ctan.org/tex-archive/fonts/tex-gyre/
It is under the Gust Font Source license which derives from
the LaTex Public License. It is, for this one, at least
possible to adapt the makefile to download the font during
the build process (the font is not packaged outside of
TexLive in most distributions). I can do this if you want.

The others fonts are private ones. Actually, the obvious
choice to replace them is the Libertine font, but it does
not have the elegance of the garalde choosen by Gunnar, and
so, is not a very good choice for a demonstration file.
There exist a garalde on the CTAN, but the last time I
checked it, it was only containing a minimal set of glyphs,
and so it is not a better choice. Finding an appropriate
free font will be difficult...

Once the font is choosen, we still have to re-write the .tr
files, since they make an intensive usage of the font
features of heirloom. I now have some experience with this,
and can do it if needed.

Cheers,
Pierre-Jean.