[Debian GNUstep maintainers] First version of split gnustep-dl2 at mentors

[Federico Giménez Nieto]

Hi,

2010/3/1 Yavor Doganov <yavor at gnu.org>:
> I see no doc-base file here?  (OK, it's not strictly necessary,
> although IMHO it would be nice to have it as this is a "must read" if
> someone wants to use GDL2 -- the API reference manuals look quite
> nebulous to me without reading the introduction first.)
>

It should be there, i created it as gnustep-dl2.doc-base, with HTML
and PDF formats...

> The Info file is installed in /usr/share/doc/gnustep-dl2 instead of
> /usr/share/info, so of course the reference in the DIR file won't be
> generated by install-info's trigger.  TTBOMK gnustep-make does the
> right thing for Info manuals; have you verified why this happens?
> It's wrong.  (As a wild guess, it might be due to the .install file.)

Yes, i misplaced the installation of the info file in the .docs,
instead of the .install, now it is fixed.

>
> Furthermore, your add_direntry.patch is wrong; the addition should be
> something like:
>
> @dircategory Software libraries
> @direntry
> * GDL2: (GDL2-Intro).   GNUstep Database Library Introduction.
> @end direntry
>
> (Or: Introduction to the GNUstep Database Library.)
>

Ok, fixed.

>
> It is important to have a @dircategory besides @direntry, because many
> users do not know the name of the reference and browse the DIR file to
> find what they need.
>

Added. I had a quick look at the Free Software Directory and didn't
find any category related to GNUstep, nor Objective-C.

>> > API documentation.  These belong in libgnustep-dl2-dev.
>
>> Done, i've also added a doc-base file here.
>
> Oddly, the documentation is again added under /usr/share/doc/<package>
> instead of /usr/share/GNUstep/Documentation.  Again a guess, it looks
> like they ought to be installed in the right place if you tweak your
> .install file.
>

In this case it is intentional, shouldn't be the documentation placed
at /usr/share/doc/<package> according to the FHS?

> Slightly related: Why do you introduce a spurious `build' dir and
> enforce such a weird (well, at least confusing for me) format for the
> .install files?  Debhelper supports multiple binary packages out of
> the box, so it looks like unnecessary complication for me.  You just
> make your life harder for no apparent benefit.  (I may be missing
> something, though.)
>

This was the first approach i took when i begun splitting the package
(with the phony tags for each package and all that unuseful stuff,
mostly following [1], and without knowing that debian/tmp is the
default DESTDIR when building a source package that produces multiple
binary packages :)), fixed, now it is much cleaner.

>> Ok, both not installed. I haven't find a good source for the manpages
>> of DBModeler, eoutil and gdlgsdoc, where could i obtain it?
>
> I can feel your pain.  The best place to look at is the source code
> that generates these binaries -- it has comments at least, and you can
> figure out what the tool does by reading the code.  I know that's
> neither encouraging nor very pleasant, but that knwoledge would help
> you anyways in the maintenance of the package.
>
> You can also skim through GDL-related articles at wiki.gnustep.org,
> although I don't think there's much.
>

*sigh* Ok, i'll take a look :)

>
> * Feel free to fix the NMU changelog retroactively -- it has invalid
>  chars (the quotation marks around NSArray).
>

Done

>
> (I hope that my comments do not discourage you -- as I mentioned
> before, gnustep-dl2 is a complex package, so there's nothing wrong to
> take a round or two to bring into shape.  I also do not purport to be
> a wizard in Debian packaging or GNUstep knowledge, so feel free to ask
> for a second opinion at any time.)
>
>

Not at all, i'm learning a lot from all this comments, thanks for your patience.

The new version is uploaded [2], cheers,
Federico

[1] http://wiki.debian.org/PkgSplit
[2] http://mentors.debian.net/debian/pool/main/g/gnustep-dl2/gnustep-dl2_0.12.0-1.dsc