[FM Discuss] Versioning for entire collections

[Edward Cherlin]

On Fri, Oct 17, 2008 at 1:52 PM, adam hyde <adam at flossmanuals.net> wrote:
> A deb would be fantastic...were you thinking of doing it in html or
> using pdf? I was actually pondering the possibility of a simple GTK
> reader...too fancy? We could (for example) export to docbook if we could
> find a nice reading app...

There are documentation .debs in a number of formats. A quick look in
Synaptic shows more than a thousand packages with doc in the name. I
have documentation stored in man, info, docbook, and html formats, and
I see packages in JavaDoc, PyDoc, and Perl .pod files. Take a look at
the doc-base package.

utilities to manage online documentation
This package contains utilities to manage documentation installed on
a Debian system.  It contains a database of document metadata.
Various third-party systems such as 'dwww', 'dhelp',  'doc-central'
or 'scrollkeeper'  use this data to provide a catalog of available
documentation.

If you want to get additional information about 'doc-base' please
consult the `Debian doc-base Manual' included in this package.

> as for the 'release' idea..., the content of different manuals is
> updated at different rates. For example, Sugar is updated almost daily
> at the moment. Whereas I haven't updated MuSE for 4 months.

Sugar is not a monolith, but an assemblage of many modules. We can
surely version docs along with module releases. Nobody publishes docs
on daily development builds anyway, only on point releases.

> Im not sure how we could do such a 'release' given these
> circumstances...

We could ask some of the other projects that do this. Certainly the
application and doc files in Debian and Ubuntu have versioning
applied.

Although when I look, I see oddities like

drgeo 1.1.0-1ubuntu1
drgeo-doc 1.5-2.1

> adam
>
>
> On Fri, 2008-10-17 at 15:56 -0400, Luke Faraone wrote:
>> Hey all,
>>
>> If I'm planning on making DEB packages out of FLOSSManuals content, is
>> there any way to have a manual "release"?
>>
>> Like when it's been checked over that it works with version of the
>> software foo by person.
>>
>> -lf
>>
>> _______________________________________________
>> Discuss mailing list
>> Discuss at lists.flossmanuals.net
>> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
> --
> Adam Hyde
> Founder FLOSS Manuals
> http://www.flossmanuals.net
>
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net

-- 
Silent Thunder (默雷/धर्ममेघशब्दगर्ज ) is my name
And Children are my nation.
The Cosmos is my dwelling place,
The Truth my destination.