Previous mail
Next mail
Unformatted/full headers
Overview 10 days
Subject
Date
Thread
Author
From: Mirsad Todorovac
Subject: Doc changes GPC
Date: 7 May 2003, 10:20:15
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
Previous mail
Next mail
Unformatted/full headers
Overview 10 days
Subject
Date
Thread
Author
| Author | Subject | Date |
|---|---|---|
| Frank Heckenbach | Doc changes GPC | 7 May 2003, 15:05:05 |
| Author | Subject | Date |
|---|---|---|
| Frank Heckenbach | Doc changes GPC | 7 May 2003, 01:07:48 |
Note: This page contains information that does not originate from the owner of this web site, but from the authors of the mails archived. The owner of this web site is not responsible for the content of such information. Any use of that infomation requires the consent of the respective author.
Where WWW addresses (URLs) in the mails archived are marked as hyperlinks, this is only for the comfort of the reader. The content of the web pages linked to like this does not necessarily reflect the opinion of the owner of this web site or of the authors of the mails archived. The owner of this web site is not responsible for the content of such web pages. Those pages are explicitly not to be considered as part of the content of this page, but merely as references.
This page was created by Crystal 0.999 (Linux 2.4.27/i686).