Re: new documentation on how to develop Debian packages available
Guy Maor wrote:
> On Thu, 22 Aug 1996, Shaya Potter wrote:
>
> > Is there a postscript version of the documents
>
> Yes, in the directory ftp://chiark.chu.cam.ac.uk/users/ian/dpkg-doc/
> you'll find various versions of the files, including postscript.
>
> Once again, these are *DRAFT* documents which do *NOT* reflect current
> policies. Although major changes are unlikely, they are certainly
> possible.
>
> If you are a prospective developer, please also get the latest hello
> and dpkg packages from /debian/project/experimental to play with. The
> same caveats apply; you should *NOT* upload any packages using the new
> source format.
>
In an effort to save some time and possibly some trees, note that:
The new documents are provided in the most recent versions of dpkg
(>=1.3.3). They are in /usr/doc/dpkg as HTML files.
If you get the source for dpkg version 1.3.3, you will find the SGML
source files from which these HTML files were generated using
the new debiandoc script developed by Ian Jackson. (Thanks, Ian!).
In order to translate those files into Postscript, you need to install
debiandoc-sgml, linuxdoc-sgml, sp, and sgmlspm. Then you can convert
the SGML source files into postscript using the command
debiandoc2ps programmer.sgml
debiandoc2ps policy.sgml
Then, if you live on the West side of the Atlantic, you probably
then will want to run the command
psresize -Pa4 -pletter programmer.ps > programmer.ps.letter
and then you want to print programmer.ps.letter.
Assuming not everyone wants to go through all this, it might help some
folks to put the Postscript files (in both A4 and letter size formats)
on the WWW site. These documents have been so badly needed for so long
that it seems that it would be a really Good Thing to do whatever
can be done to promulgate them (IMHO).
Regards,
Susan Kleinmann
Reply to: