On Wed, 7 May 2003, Frank Heckenbach wrote:
Mirsad Todorovac wrote:
On Sat, 3 May 2003, Frank Heckenbach wrote:
BTW, I thought of making [Example]s follow-able in "Highlights" section. Can this be done without much hassle?
They are in the HTML output (via `examplehref'). I don't think there's any way to link to external (plain-text, or Pascal) files from Info, DVI, PS or PDF.
Frank
BTW, Frank, have you seen the HTML-ized listings (done by their LXR) at http://lxr.mozilla.org/ ??
What do you think -- I think generating cross-refs and line numbers is a piece of cake, such as seen at
http://lxr.nozilla.org/mozilla1.0/source/jpeg/example.c
Also I had dillemas about generating and including texinfo source for all examples mentioned as examples or something else. Especially since source may not always be available, and users are sometimes l@zy ...
Even not that. I.e. at home, at my mandrake box, I had gpc docs only, and alas no internet connection -- this sort of situation can happen to people who are not online.
I'm not sure if I understand exactly what you mean.
Anyway, the examples mentioned in about.texi are included in source and binary distributions in a demos/ directory, so one should always have them if one has GPC.
Err, well. On Debian, it didn't come in my default configuration. But it didn't include any info files, just gpc.1 manpage.
It takes a root intervention to install gpc-2.95-doc pkg.
True, .../docdemos/*.pas are in the same package as gpc-295.info ...
Yet, if we had docdemos html-ized, then I could reference particular line or construction within the demo! (As seen at lrx.mozzila.org example.)
The "docdemos" are part of the texi source (within `@example') and are extracted when installing GPC (and therefore part of binary distributions), so also "everyone" should have them.
With the exception of being on a [Debian or other] server where admin deprecates GPC ...
If you have the GPC sources (and a number of tools, which should be no problem on GNU/Linux), you can even build a local copy of the home page (`make pascal.html'), with all the examples etc. included.
Err, yes -- then again, if I had something like this _______________________________________________________________ <HTML> <HEAD><TITLE>Example 1</TITLE></HEAD> <BODY> <PRE> <A NAME="line001">1</A> /* Copyright FSF 2003 <A NAME="line002">2</A> Copying by terms of GPL */ <A NAME="line003">3</A> <A NAME="line004">4</A> program demo(output); <A NAME="line005">5</A> <A NAME="line006">6</A> uses GPC; <A NAME="line007">7</A> uses GMP; <A NAME="line008">8</A> . . . _______________________________________________________________
... then I could refer to it as this:
you can include GMP arbitrary precision mathematical in your program like in <a href="gmpdemo.pas#line007">this example</a>.
In a longer example, not this simplistic one, it could make a difference for the reader IMHO.
I'd have to see, however, how they manage to have link http://lxr.mozilla.org/.../example.c that gives a HTML document type ...
Mirsad