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

[Yavor Doganov]

В Fri, 05 Mar 2010 11:24:11 +0100, Federico Giménez Nieto написа:
> 2010/3/2 Yavor Doganov <yavor at gnu.org>:
>> gdlgsdoc is a mystery to me, give me some time to take a look at it.
>>
> Ok, i'll begin with DBModeler and eoutil.

About gdlgsdoc:
It seems to me that this tool is either incomplete or buggy (or both).
Its task, as I understand it, is to produce .gsdoc files from .eomodel
files, which are then processed with autogsdoc to produce .html.
However, I couldn't make it produce anything useful (more precisely:
anything at all).  Doing

  gdlgsdoc --verbose=1 Examples/library.eomodel

produces no .gsdoc file (and exits with success).  Passing
--template=sometemplate.gsdoc actually writes a .gsdoc file which
is byte-to-byte equivalent to the template. So I'd suggest to file a
bug at
https://savannah.gnu.org/bugs/?func=additem&group=gnustep (Category:
gdl2, Item Group: Documentation) asking for clarification).  If the
tool is really disfunctional, it is perfectly OK to delete it from
debian/rules and get yourself releaved from the duty of shipping a
manpage (for the time being, at least).

I might be wrong here, as I haven't investigated the source code
thoroughly.

> I've removed also a big .igsdoc file, i guess it is fine to remove
> it too.

Yes.

> Ok, i've added a copyright notice for the html files of GDL2Intro
> (stating their final installation path), i think that there is nothing
> left...

Hmm, DBModeler, eoutil, etc. are under GPLv3+, I think...


Some more comments:

* If you pass doc=yes to $(MAKE) in the clean rule, doesn't
  gnustep-make delete all generated files?  If it does, consider doing
  so instead of manually deleting them as it is cleaner/saner
  (upstream may add more documents in the future, or gnustep-make may
  use a different mechanism, especially considering the recent
  upstream merge of texi2html into texinfo).  If it doesn't, then
  please file a bug against gnustep-make (Severity: normal); I'll try
  to fix it.

* Just an enhancement: you could ship the contents of Examples/ under
  /usr/share/doc/gnustep-dl2/examples.  dh_installexamples ought to do
  this automatically.