Subject: Too-verbose commit logs
To: Martti Kuparinen <martti@netbsd.org>
From: Johnny Lam <jlam@jgrind.org>
List: pkgsrc-changes
Date: 03/09/2002 07:28:34
On Sat, Mar 09, 2002 at 03:58:05PM +0200, Martti Kuparinen wrote:
> 
> Modified Files:
> 	pkgsrc/print/apsfilter: Makefile PLIST distinfo
> 	pkgsrc/print/apsfilter/patches: patch-aa
> 
> Log Message:
> Updated apsfilter to 7.2.2
> 
> NOTE: This works just fine with ghostscript-6.01 even though the
>       setup script says you need 6.50 or later...

That's good to hear.  Thanks for doing this update.

Regarding putting entire changelogs in commit messages, it's really a
little too verbose.  As Packages.txt states in Section 11.3 (emphasis
added):

	Please always put a *concise*, *appropriate* and *relevant*
	summary of the changes between old and new versions into the
	commit log when updating a package.

When I update most packages, at a minimum, I go through the supplied
changelog and trim out stuff that's not user-noticable, and also stuff
that's not for any of the pkgsrc-supported platforms, i.e.  keep stuff
for NetBSD, Solaris, Linux, and Darwin, but toss out all of the FreeBSD,
OpenBSD, Netware, Win32, and BeOS stuff.

So for this apsfilter update, lines worth putting in the commit log are:

> - new driver scripts: ljet4l, pips/sc70s, pips/sc80s,
>   stp/pcl-2, stp/pcl-4
> - adjust psnup rotation to various converters for landscape mode
> - introduce IGNORE_LPD_RAW variable to please buggy spoolers that
>   send jobs in raw mode
> - make apspreview use global "restrictions" file
> - support for NetWare (Novell) remote printer
> - save network traffic by supporting "remote copies"
>   via new REMOTE_COPIES variable. This tells lpd and Netware
>   print spooler to do copies themselves (enabled by default).
> - only preview if aps2file generated PostScript
> - use secure temporary directory in SETUP
> - driver: stp/escp2-1160 (thanks to <andrew@ugh.net.au>)
> - the bjc600 driver script has four new siblings (bjc50, bjc70,
>   bjc4000, bjc7000) to properly handle printers with different
>   print resolutions

While the rest of those below just clutter and take up space on
cvs.netbsd.org, anoncvs.netbsd.org, and its mirrors.

	Cheers,

	-- Johnny Lam <jlam@jgrind.org>

> - replace awk "duplex" function with psset call
> - add landscape option to enscript command line
> - sanitize ": ${foo:-bar}" to ": ${foo:=bar}"
> - make n{c}print line whitespace-safe
> - save return code in global temporary file
> - typo in wmf2eps line
> - get basedir in SETUP from configure
> - protect $foo[bar] contructs from being expanded to array
>   elements by zsh
> - add "-dPARANOIDSAFER" for gs7.04 (harmless for all older releases)
> - save "rm" and "rp" in SETUP.cfg
> - add some hints w.r.t landscape and n-up in handbook
> - remove media types in scripts for some PCL printers
> - be more helpful with "invalid method"
> - LaserJet 4L needs fixed 300dpi
> - LN macro in Makefile needs -n switch -- we must
>   create a directory link even if one exists already
> - MAPPING update
> - change email address in various places
> - remove apsfilter installation error when typing "make install"
>   by using ln's -f (force) option to overwrite an existing symlink
>   (just in case you overwrite another installation).
> - fix some HP driver mapping in MAPPING file
> - make apspreview work again for FreeBSD (and possibly *BSD).
>   BSD uses a sed implementation, that uses only "normal" regular
>   expressions for backward compatibility not to break existing scripts.
>   Linux (GNU sed) uses "modern REs". We use now awk which turns out
>   to be more portable between different Unix flavours.
>   We use awk instead of sed in other scripts as well (SETUP,
>   aps2file).
> - import a patch from FreeBSD ports collection necessary for
>   FreeBSD-current to use "user:group" syntax for chown. Old
>   style "user.group" to change owner && group isn't supported
>   anymore. Linux's implementation of chown (from GNU) groks
>   new syntax.
> - install and test apsfilter as "non-root" user under $HOME !
>   This helps in testing new apsfilter versions, i.e. to prepare
>   a migration to a new version on a production system.
>   For this feature the configure script supports two new options:
>   --with-printcap=...  and --with-spooldir=...
> - aps2file and apspreview now handle printer aliases
> - remove bogus hpijs driver entries in setup/printer-7.00
>   (but they were correct in setup/printer-hpijs)
> - various fixes in driver/MAPPING
> - adjusted various omni/ scripts to use more reasonable
>   resolution settings
> - enable PSgs to honor HARDWARE_COPIES
> - various small SETUP clean-ups
> - create "basedir" link at install time already
> - doc/Makefile: "make clean" should remove handbook.html
>   since "configure" re-creates it from handbook.html.in
> - Make handbook generation smarter, cosmetic.