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 switched the reply to gpc-doc@gnu.de, so you don't get two messages.)
Mirsad
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.
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.
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.
Frank
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
Mirsad Todorovac wrote:
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 ...
Well, that's the decision of the Debian maintainers. I don't really approve of the decision to put programs and documentation in separate packages (neither libraries and headers, etc.). It might save a few computer resources, but it seems to waste much more valuable human resources with questions and discussions (such as these ...). But if it's a general Debian policy, I guess we can't change it ...
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.)
If you have an idea how to support it in all the output formats (HTML is not the only one) ...
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 ...
You mean he let you install GPC, but not the documentation? Then just ask him to install the source package (he's required to, by the GPL), which includes the examples, too. (He could remove them again, since they're not directly the source of the installed executables, but this will be extra work for him. ;-)
And, of course, you can always install it in your home if you have a few 100 MB spare. ;-)
I'd have to see, however, how they manage to have link http://lxr.mozilla.org/.../example.c that gives a HTML document type ...
AFAIK, they do not use Texinfo, so it might not be very relevant (just to prevent you from wasting your time) ...
Frank
-
Frank Heckenbach -
Mirsad Todorovac