Is there a PDF of the Gforth manual available?
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.
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.
I emailed you the pdf.
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.
Is there a PDF of the Gforth manual available?
https://gforth.org/manual/ has been down for a while
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.
...
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.
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 :)
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.
I didn't need anything fancy - hyperlinks for existing references and a word index. It came together easier than I expected. There were some false hits requiring minor tweaks to the source file. Anyway, here's the result:
https://pastebin.com/8xpT6gj1
Gforth is using texinfo, so you can generate pdf, info and ps.
(like ciforth).
Gforth offers Info, HTML, PDF, Postscript, and plain text.
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.
I could have also installed the gforth-pdf package which I was
previously unaware of:
$ sudo apt install gforth-pdf
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.
$ sudo apt install gforth-pdf
I am also unaware of that package. Where does it come from?
| Sysop: | DaiTengu |
|---|---|
| Location: | Appleton, WI |
| Users: | 1,030 |
| Nodes: | 10 (0 / 10) |
| Uptime: | 16:33:47 |
| Calls: | 13,345 |
| Calls today: | 2 |
| Files: | 186,574 |
| D/L today: |
1,310 files (335M bytes) |
| Messages: | 3,357,548 |