[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: API documentation



On Tue, 2012-05-22 at 21:49 -0400, Chris Travers wrote:
> On Tue, May 22, 2012 at 6:28 PM, Robert James Clay <..hidden..> wrote:
> >   Haven't checked to see how much space they're taking up (there are
> > currently some 61 of them) but those are currently included in the
> > Debian package.  (They're created as part of the build and I then use a
> > standard Debian helper script to get them installed in the package.)
> 
> Perfect.  Especially if you have something working for you

   Besides the man pages and files that are separately installed as
examples, I also have most of the rest of the documentation installed
with the current Debian packaging (to /usr/share/doc/ledgersmb).  The
database sub directory, for instance (though I should perhaps add
registration of at least the database/ledgersmb.html file, so that it
also shows up in the documentation menu).  The LedgerSMB Manual, for
which I have a note about investigating the creation of an HTML version
of the manual from that same source file.  The templating guide
(presuming that is it's valid), though I've wondered about providing an
html version of it with the package rather than the source tex file.
The faq.html file (is that current?).  The coding-standard.pdf (from
2006, and I'm not actually sure why I have that included in the package
installation...)


>  I will put these in a separate tarball.

   Not sure what you mean.  Separate distribution RPM archive for the
doc files associated with a particular version?  Separate distribution
archive for the documentation?


>   Don't want to make things harder for packagers by putting things in multiple places.

  Which 'things'?




Jame