[xml/sgml] Some packaging best practices ideas

[Ardo van Rangelrooij]

Hello Mark,

A couple of comments:

 - It's the current best practive to put the DH_COMPAT value in debian/compat.
 - It's preferred to comment out DH_VERBOSE
 - 'dh_installdirs' is used twice
 - 'dh_shlibdeps' for a package with only text files ???  interesting
 - Why do you have a 'configure' target?  Unless you're going here for the general
   case I would suggest to remove what you don't need.
 - Why don't you upgrade to debhelper v4?  For dh_installcatalogs you even need
   'debhelper (>= 4.1.75)' (see my sgml-base web page).

And from the nitpicking department: look at one of my rules files for a perfect
aligned layout (yes, I'm that picky).  Even the order of the make targets has
been put into thought.  And yes, the order of the .PHONY dependends matches the
order of the make targets.  But that's just me. :-)

Thanks,
Ardo

Mark Johnson (mrj@debian.org) wrote:
> Hi Gang,
> 
> I'm finally happy with the build setup I have for an xml resource (not
> yet including XML Catalog support, natch). 
> 
> Check out the files under docbook-slides/debian: 
> 
> http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/packages/docbook-slides/debian/?cvsroot=debian-xml-sgml
> 
> Rules is practically empty, and heavy use is made of the debhelper
> scripts. I think this illustrates the general ideas of 'best
> practices' when it comes to packaging sgml resources.
> 
> Lemme know if your opinion differs. 
> 
> BTW, there's no need to actually read the files (except maybe
> 'rules'), the existence of all the debhelper input files is really
> what illustrates my point.
> 
> My $0.02.
> M
> 
> -- 
> _____________________________________
> Mark Johnson        <mark@dulug.duke.edu>
> Debian XML/SGML     <mrj@debian.org>
> Home Page:          <http://dulug.duke.edu/~mark/>
> GPG fp: 50DF A22D 5119 3485 E9E4  89B2 BCBC B2C8 2BE2 FE81
> 
> 
> _______________________________________________
> Debian-xml-sgml-devel mailing list
> Debian-xml-sgml-devel@lists.alioth.debian.org
> http://lists.alioth.debian.org/mailman/listinfo/debian-xml-sgml-devel

-- 
Ardo van Rangelrooij
home email: ardo@debian.org
home page:  http://people.debian.org/~ardo
GnuPG fp:   3B 1F 21 72 00 5C 3A 73  7F 72 DF D9 90 78 47 F9