Re: [Groff] [Heirloom] Generating doc/ files

[Blake McBride]

Using private, non-standard, or not-included fonts to document the package
with the fonts makes utterly no sense.  The documents should be changed to
use included or standard fonts only.  This will avoid every new user from
questioning their build or the package itself.  If included or standard
fonts are not good enough - take that up with X11 et al.

Of course, using private fonts in a private document is always fine.

Blake



On Wed, Aug 27, 2014 at 7:51 AM, Pierre-Jean <address@hidden> wrote:

>
> 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.
>
>
>