• Re: Gforth manual PDF?

    From albert@spenarnc.xs4all.nl@21:1/5 to dxforth@gmail.com on Sat Feb 15 12:33:20 2025
    In article <96a4c719cbed4db718e0f8ed0e6bff667a37aa3c@i2pn2.org>,
    dxf <dxforth@gmail.com> wrote:
    On 15/02/2025 1:45 pm, Paul Rubin wrote:
    No idea what's up with gforth.org. I do
    remember there is an html version of the manual online, but maybe you
    wanted something printable.

    Some systems offer both html and pdf e.g. Vfx. There I go for the pdf
    as it has a word index. There seem to be other differences e.g. f/p >suggesting they're maintained separately. In DX-Forth I just use a
    text file doc. I considered providing html but as CP/M and DOS versions
    are somewhat different, I figured it would become too much work.

    Gforth is using texinfo, so you can generate pdf, info and ps.
    (like ciforth).
    In ciforth I generate a separate html, as a quick reference, with
    elaborate see also sections that you can click through. It starts with
    an alphabetic glossary index.


    --
    Temu exploits Christians: (Disclaimer, only 10 apostles)
    Last Supper Acrylic Suncatcher - 15Cm Round Stained Glass- Style Wall
    Art For Home, Office And Garden Decor - Perfect For Windows, Bars,
    And Gifts For Friends Family And Colleagues.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Anton Ertl@21:1/5 to Buzz McCool on Sat Feb 15 17:47:56 2025
    Buzz McCool <buzz_mccool@yahoo.com> writes:
    Is there a PDF of the Gforth manual available?

    For Gforth-0.7 you can find the pdf at https://www.complang.tuwien.ac.at/forth/gforth/gforth-0.7.0.pdf

    Alternatively, a packaged version of the 0.7 manual in HTML form is
    available at

    https://www.complang.tuwien.ac.at/forth/gforth/gforth-html-0.7.0.zip

    This web server currently sometimes provides very slow service at the
    moment. Hopefully this will change next Tuesday.

    https://gforth.org/manual/ has been down for a while

    For now you will find the manual of a recent snapshot at

    https://net2o.de/gforth/

    - anton
    --
    M. Anton Ertl http://www.complang.tuwien.ac.at/anton/home.html
    comp.lang.forth FAQs: http://www.complang.tuwien.ac.at/forth/faq/toc.html
    New standard: https://forth-standard.org/
    EuroForth 2023 proceedings: http://www.euroforth.org/ef23/papers/
    EuroForth 2024 proceedings: http://www.euroforth.org/ef24/papers/

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Anton Ertl@21:1/5 to dxf on Sat Feb 15 17:53:50 2025
    dxf <dxforth@gmail.com> writes:
    On 15/02/2025 1:45 pm, Paul Rubin wrote:
    No idea what's up with gforth.org. I do
    remember there is an html version of the manual online, but maybe you
    wanted something printable.

    Some systems offer both html and pdf e.g. Vfx.

    Gforth offers Info, HTML, PDF, Postscript, and plain text.

    There I go for the pdf
    as it has a word index.

    For Gforth, the HTML format has a word index <https://net2o.de/gforth/Word-Index.html> as well as a concept and
    word index <https://net2o.de/gforth/Concept-Index.html>. Actually all
    formats have them, including the plain text format, where you get
    entries like

    * x, stack item type: Notation. (line 3840)

    - anton
    --
    M. Anton Ertl http://www.complang.tuwien.ac.at/anton/home.html
    comp.lang.forth FAQs: http://www.complang.tuwien.ac.at/forth/faq/toc.html
    New standard: https://forth-standard.org/
    EuroForth 2023 proceedings: http://www.euroforth.org/ef23/papers/
    EuroForth 2024 proceedings: http://www.euroforth.org/ef24/papers/

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From albert@spenarnc.xs4all.nl@21:1/5 to dxforth@gmail.com on Sun Feb 16 12:42:49 2025
    In article <f0aebc074a8aba9e1fff166afbed849369ccecbc@i2pn2.org>,
    dxf <dxforth@gmail.com> wrote:
    On 15/02/2025 10:33 pm, albert@spenarnc.xs4all.nl wrote:
    ...
    In ciforth I generate a separate html, as a quick reference, with
    elaborate see also sections that you can click through. It starts with
    an alphabetic glossary index.

    Checking my glossary file I should be able to do something similar.
    Key is identifying each entry (word). As these uniquely begin with a single >space there should be no false hits. From there it will be easy to bookmark >and generate an index. It seems I've found myself a new forth project :)

    The great effort is in the ALSO's. You don't want to leave important references out. On the other hand you don't want to reference too many words,
    that are only relevant if you need an in depth knowledge. It is a compromise and time and again I discover that I have left an essential reference that a user couldn't easily find, or that a reference isn't important enough to keep.

    In 2000 I invested in a bunch of m4 macro's that aid in grouping and alphabetizing word's. For all new Forth's I run the macro's after
    adding, removing and redacting doc's for new or changed words.
    There is some 10 Forth's now using that.

    https://github.com/albertvanderhorst/ciforth

    For example I generated a FreeBSD Forth in days, with doc's instantly
    usable.

    Groetjes Albert
    --
    Temu exploits Christians: (Disclaimer, only 10 apostles)
    Last Supper Acrylic Suncatcher - 15Cm Round Stained Glass- Style Wall
    Art For Home, Office And Garden Decor - Perfect For Windows, Bars,
    And Gifts For Friends Family And Colleagues.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Buzz McCool@21:1/5 to albert@spenarnc.xs4all.nl on Mon Feb 17 10:21:51 2025
    On 2/15/25 03:33, albert@spenarnc.xs4all.nl wrote:

    Gforth is using texinfo, so you can generate pdf, info and ps.
    (like ciforth).

    On 2/15/25 09:53, Anton Ertl wrote:
    Gforth offers Info, HTML, PDF, Postscript, and plain text.

    I've been using a package manager to grab Gforth and should have known
    to check the tarball.

    I don't see a PDF in the ./doc folder, but I can make it from the
    PostScript file.

    ~/gforth-0.7.9_20250211/doc$ ls
    2012-words gforth.info-1 gforth.ps makedoc.fs vmgen.ps fdl.texi gforth.info-2 gforth.texi.in Makefile.in vmgen.texi gforth.1 gforth.info-3 gforth.txt standard-words.awk words gforth.css gforth.info-4 glossaries.doc version.texi.in
    gforth.info gforth.js gpl.texi vmgen.info

    I could have also installed the gforth-pdf package which I was
    previously unaware of:

    $ sudo apt install gforth-pdf
    ...
    Selecting previously unselected package gforth-pdf.
    (Reading database ... 371751 files and directories currently installed.) Preparing to unpack .../gforth-pdf_0.7.9-20250211_all.deb ...
    Unpacking gforth-pdf (0.7.9-20250211) ...
    Setting up gforth-pdf (0.7.9-20250211) ...

    $ dpkg -L gforth-pdf
    /.
    /usr
    /usr/share
    /usr/share/doc
    /usr/share/doc/gforth
    /usr/share/doc/gforth/gforth.pdf.gz
    /usr/share/doc/vmgen
    /usr/share/doc/vmgen/vmgen.pdf.gz

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Anton Ertl@21:1/5 to Buzz McCool on Tue Feb 18 07:50:59 2025
    Buzz McCool <buzz_mccool@yahoo.com> writes:
    On 2/15/25 03:33, albert@spenarnc.xs4all.nl wrote:

    Gforth is using texinfo, so you can generate pdf, info and ps.
    (like ciforth).

    On 2/15/25 09:53, Anton Ertl wrote:
    Gforth offers Info, HTML, PDF, Postscript, and plain text.

    I've been using a package manager to grab Gforth and should have known
    to check the tarball.

    I don't see a PDF in the ./doc folder, but I can make it from the
    PostScript file.

    We only put generated files in the tarball that you cannot easily
    regenerate yourself (i.e., with the usually-available tools). For
    regenerating the pdf file, you need to have texinfo installed; maybe
    we should be distributing the pdf in the tarball. I have now changed
    the Makefile to include the .pdf rather than the .ps files in the
    tarball, reflecting the loss of popularity of the .ps format.

    I could have also installed the gforth-pdf package which I was
    previously unaware of:

    $ sudo apt install gforth-pdf

    I am also unaware of that package. Where does it come from?

    - anton
    --
    M. Anton Ertl http://www.complang.tuwien.ac.at/anton/home.html
    comp.lang.forth FAQs: http://www.complang.tuwien.ac.at/forth/faq/toc.html
    New standard: https://forth-standard.org/
    EuroForth 2023 proceedings: http://www.euroforth.org/ef23/papers/
    EuroForth 2024 proceedings: http://www.euroforth.org/ef24/papers/

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Buzz McCool@21:1/5 to All on Tue Feb 18 17:49:38 2025
    On 2/15/25 09:53, Anton Ertl wrote:
    ... I have now changed
    the Makefile to include the .pdf rather than the .ps files in the
    tarball, reflecting the loss of popularity of the .ps format.

    Thank you Anton!

    $ sudo apt install gforth-pdf

    I am also unaware of that package. Where does it come from?

    Looks like it comes from you:

    $ apt show gforth-pdf
    Package: gforth-pdf
    Version: 0.7.9-20250211
    Priority: extra
    Section: programming
    Source: gforth
    Maintainer: Bernd Paysan <bernd.paysan@gmx.de>
    Installed-Size: 1,749 kB
    Provides: gforth-doc
    Download-Size: 1,745 kB
    APT-Manual-Installed: yes
    APT-Sources: https://net2o.de/debian stable/main all Packages
    Description: GNU Forth
    Gforth is the Forth implementation of the GNU project, providing all
    features of the ANS Forth (Forth-94) and the Forth-2012 standards.
    .
    This is the documentation in PDF format

    $ cd /usr/share/doc/gforth
    $ ls -la
    total 1500
    drwxr-xr-x 2 root root 4096 Feb 17 10:15 .
    drwxr-xr-x 2292 root root 81920 Feb 11 17:42 ..
    -rw-r--r-- 1 root root 1445762 Dec 26 2010 gforth.pdf.gz

    $ sudo gunzip gforth.pdf.gz
    [sudo] password for mccool:
    $ ls -la
    total 1548
    drwxr-xr-x 2 root root 4096 Feb 18 17:41 .
    drwxr-xr-x 2292 root root 81920 Feb 11 17:42 ..
    -rw-r--r-- 1 root root 1494604 Dec 26 2010 gforth.pdf
    $ atril gforth.pd


    The PDF is dated February 11th 2025

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Buzz McCool@21:1/5 to All on Fri Feb 14 07:55:15 2025
    Is there a PDF of the Gforth manual available?

    https://gforth.org/manual/ has been down for a while so I'm forced to
    use archive.org to peruse the docs.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Paul Rubin@21:1/5 to Buzz McCool on Fri Feb 14 10:39:55 2025
    Buzz McCool <buzz_mccool@yahoo.com> writes:
    Is there a PDF of the Gforth manual available?

    I was able to make the pdf in the source directory using tex, texinfo,
    etc. The pdf is about 2.1MB. I could email it to you, or post it
    online temporarily. This is for the current 0.7.9 snapshot, assuming
    that's what you want.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Buzz McCool@21:1/5 to Paul Rubin on Fri Feb 14 15:30:50 2025
    On 2/14/2025 10:39 AM, Paul Rubin wrote:
    Buzz McCool <buzz_mccool@yahoo.com> writes:
    Is there a PDF of the Gforth manual available?

    I was able to make the pdf in the source directory using tex, texinfo,
    etc. The pdf is about 2.1MB. I could email it to you, or post it
    online temporarily. This is for the current 0.7.9 snapshot, assuming
    that's what you want.

    Yes, I'm using Gforth 0.7.9_20250211 .

    You can post it online or email to buzz_mccool@yahoo.com

    This isn't the first time https://gforth.org/manual/ has given me "503
    Bad Gateway" or "503 Service Temporarily Unavailable" messages.

    I really appreciate your assistance!

    P.S. Thanks for the pForth tip from earlier this week too.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Paul Rubin@21:1/5 to All on Fri Feb 14 18:45:36 2025
    I emailed you the pdf. No idea what's up with gforth.org. I do
    remember there is an html version of the manual online, but maybe you
    wanted something printable.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Buzz McCool@21:1/5 to Paul Rubin on Fri Feb 14 22:18:11 2025
    On 2/14/25 18:45, Paul Rubin wrote:
    I emailed you the pdf.

    Got it! Thanks again.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)