Re: [gforth] PDF version of the Gforth documentation?

[Koz Ross]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Thanks for that Anton - that manual looks great!

As for the font - this is a known issue that has happened with other
manuals (the GNU Smalltalk one in most recent memory). Here is the
issue that I got when compiling from source (using 'make doc'):

make[1]: Entering directory '/home/koz/gforth/doc'
makeinfo -I . gforth.texi
gforth.texi:23421: warning: @pxref node name should not contain `.'
gforth.texi:23422: warning: @pxref node name should not contain `.'
gforth.texi:23424: warning: @pxref node name should not contain `.'
gforth.texi:23441: warning: @pxref node name should not contain `.'
gforth.texi:23457: warning: @pxref node name should not contain `.'
gforth.texi:23982: warning: @pxref node name should not contain `.'
gforth.texi:24187: warning: @ref node name should not contain `.'
makeinfo -I . vmgen.texi
vmgen.texi:400: warning: @pxref node name should not contain `.'
vmgen.texi:686: warning: @pxref node name should not contain `.'
vmgen.texi:1613: warning: @pxref node name should not contain `.'
makeinfo -I . --html gforth.texi
makeinfo -I . --html vmgen.texi
texi2dvi -I . gforth.texi
This is pdfTeX, Version 3.14159265-2.6-1.40.16 (TeX Live 2015/Parabola)
(preloaded format=etex) restricted \write18 enabled.
entering extended mode
(./gforth.texi (/usr/share/texmf-dist/tex/texinfo/texinfo.tex
Loading texinfo [version 2015-10-21.19]: pdf, fonts, markup, glyphs,
page headings, tables, conditionals, indexing, sectioning, toc,
environments, defuns, macros, cross references, insertions,
(/usr/share/texmf-dist/tex/generic/epsf/epsf.tex
This is `epsf.tex' v2.7.4 <14 February 2011>
) localization, formatting, and turning on texinfo input format.)
(/home/koz/gforth/doc/version.texi) [1] [2] [-1] (Preface) Chapter 1 [1]
Cross reference values unknown; you must run TeX again. Chapter 2 [2]
[3] [4] [5] [6] [7] [8] Chapter 3 [9] [10] [11] [12] [13] [14] [15]
[16] [17] [18] [19] [20] [21]
Overfull \hbox (14.94176pt too wide) in paragraph at lines 2232--2232
 address@hidden 1 0 / . \ "Floating-point unidentified fault" in Gforth on
some plat forms[] |
[22] [23] [24] [25]
Underfull \hbox (badness 10000) in paragraph at lines 2596--2605
@textsl (@texttt
http://docs.sun.com/source/806-3568/address@hidden ), ACM
Com-put-ing [26]
Underfull \hbox (badness 10000) in paragraph at lines 2660--2668
 @textsl (@texttt
http://home.pipeline.com/~hbaker1/sigplannotices/sigcol05.ps.
address@hidden ), [27] [28] [29] [30] [31] [32] [33] [34] [35]
Overfull \hbox (14.94176pt too wide) in paragraph at lines 3342--3342
 address@hidden : compile-vmul-step ( compilation: n --; run-time: n1 addr1
- -- n2 ad dr2 )[] |
[36] [37] Chapter 4 [38] [39] [40] [41] [42] [43] [44] [45] [46] [47]
[48] Chapter 5 [49] [50] [51] [52] [53] [54] [55]
Underfull \hbox (badness 10000) in paragraph at lines 5364--5373
@textsl (@texttt
http://docs.sun.com/source/806-3568/address@hidden ), ACM
Com-put-ing [56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66] [67]
[68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78] [79]
Overfull \hbox (20.69044pt too wide) in paragraph at lines 8445--8445
 address@hidden CREATE new-word2 1 cells allot  \ reserve 1 cell - initial
value und efined[] |

Overfull \hbox (14.94176pt too wide) in paragraph at lines 8446--8446
 address@hidden CREATE new-word3 4 ,            \ reserve 1 cell and
initialise it ( to 4)[] |
[80] [81] [82] [83] [84] [85] [86] [87] [88]
Overfull \hbox (49.43388pt too wide) in paragraph at lines 9325--9325
 []    @texttt 2@ swap here name string, ( u table-xt disasm-xt c-addr
) \ reme mber string[] |
[89] [90]
Overfull \hbox (47.63586pt too wide) in paragraph at lines 9553--9553
address@hidden action-of[]       @textit in-ter-pre-ta-tion @texttt "@textit
address@hidden xttt " @textit -- xt; com-pi-la-tion @texttt "@textit
address@hidden " @textit -- ; run-time -- xt         @textrm gforth
``action-| [91] [92] [93] [94] [95] [96] [97] [98] [99] [100] [101]
[102] [103] [104] kpathsea: Running mktextfm ecrm1095
mktextfm: Running mf-nowin -progname=mf \mode:=ljfour; mag:=1;
nonstopmode; input ecrm1095 This is METAFONT, Version 2.7182818 (TeX
Live 2015/Parabola) (preloaded base=mf)


kpathsea: Running mktexmf ecrm1095
! I can't find file `ecrm1095'.
<*> ...ljfour; mag:=1; nonstopmode; input ecrm1095
                                                  
Please type another input file name
! Emergency stop.
<*> ...ljfour; mag:=1; nonstopmode; input ecrm1095
                                                  
Transcript written on mfput.log.
grep: ecrm1095.log: No such file or directory
mktextfm: `mf-nowin -progname=mf \mode:=ljfour; mag:=1; nonstopmode;
input ecrm1095' failed to make ecrm1095.tfm. kpathsea: Appending font
creation commands to missfont.log.

./gforth.texi:10951: Font @thisecfont=ecrm1095 at 11.0pt not loadable:
Metric ( TFM) file not found.
<to be read again> 
                   @thisecfont 
@{->address@hidden @else @ecfont 
                                @fi @char 123}
l.10951 Let @{
              @i{a address@hidden represent the @i{optional} presence of any of
the ch...

- ---

I decided to provide the whole terminal dump, in case it wasn't a font
issue.

- -- 
Koz Ross <address@hidden>
www.retro-freedom.nz

If you aren't using GPG, you should be!
https://emailselfdefense.fsf.org/en.

Please don't send me Word or PowerPoint attachments. See
http://www.gnu.org/philosophy/no-word-attachments.html for why.

Proud member of the Open Wireless Movement. Find out more at
https://openwireless.org/

Proud member of Peers, at http://peers.community/ . We grow freedom.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iQEcBAEBCAAGBQJW/5zJAAoJEJARVr/lAw1AvfUH/R47EFwfeVArhPVIRI9Nidhi
H5kPRX3e4aY7Df+ihj/qXpYR8owL+bpThHUU3vpY3Zqhifr1sbBursXOfWtOrBBo
7nCXj942/MABHAVKITOPBRBgG8Wi4/56uvwaBKOfHdFF/e+mFvtD/8b4CJOLhqzE
h1GZRKLdxhavRObVqLyhK6AJ8imI1jLrlWm3wyMQupFkRtNG8HhKprWc3Rq1tpwR
7+0LnmdZkhpxlK7nA6WXoEyu2fgBS8MDzEIARKvbOd/vBygXesbmspl1xBpEtwUh
QSjUQATuC6aTdyfrwRpGN45WTiLrCy8m+NpTqZOjNGWo1cBAmtZbsOWUWvTLyNQ=
=l/d+
-----END PGP SIGNATURE-----