On Wed, 23 May 2001, Yotam Rubin wrote:
> Gentle people,
>
> I have encountered several issues while packaging freecell-solver for Debian.
>
> Package splitting:
> According to Debian policy, a library package should not contain binaries,
> therefore my source package generates the following binary packages:
> o libfreecell-solver0 -- Contains the files necessary for runtime.
> o libfreecell-solver-dev -- Contains the headers, development documentation
> and the .a file.
> o freecell-solver - Contains the binaries that come with the main tarball.
>
I have done the same splitting for the RPM files.
> Each binary should have a respective manpage, according to Debian policy.
> Apparently, the contributed binaries and the native binary do not have
> documentation in the form of man pages. Perhaps you can compose the appropriate
> man pages?
>
Well, Freecell Solver is documented with a group of text files, and I'd
like to keep it at that for maximal portability and usability. However, I
could make symbolic man-pages that will refer the user to those documents
or to its "--help" switch.
I could write something basic with perlpod, because that will give me the
chance to further convert them into TeX and HTML. Thinking about it: POD
can convert to text too, so maybe the entire documentation should be
converted to perlpod.
As for the library, I am planning to write a document covering the
freecell_solver_user_...() API, but I did not start yet. I'll let you know
when it is ready.
Thanks for your efforts.
Regards,
Shlomi Fish
> Regards, Yotam Rubin
>
>
> To unsubscribe from this group, send an email to:
> fc-solve-discuss-unsubscribe_at_yahoogroups.com
>
>
>
> Your use of Yahoo! Groups is subject to http://docs.yahoo.com/info/terms/
>
>
----------------------------------------------------------------------
Shlomi Fish shlomif_at_vipe.technion.ac.il
Home Page:
http://t2.technion.ac.il/~shlomif/
Home E-mail: shlomif_at_techie.com
A more experienced programmer does not make less bugs. He just realizes
what went wrong more quickly.
Received on Thu May 24 2001 - 13:10:31 IDT