On Wed, 18 Apr 2012 01:21:02 +0100 Bruce Dubbs <[email protected]> wrote:
> I have been updating the files repository for some time. There is a daily > script that runs to tell us what is in the book but not currently in the > repository. > > I sometimes have a problem matching the missing package by looking at the > TOC. > The problem is that we are not really consistent in section naming. In some > cases we capitalize: > > Hd2u-1.0.1 > GTK-Doc-1.18 > Graphviz-2.26.3 > > In some cases we don't: > > autogen-5.12 > bc-1.06.95 > usbutils-005 > > The real problem is when the title has spaces: > > GNOME Desktop-3.4.1 > GNOME Doc Utils-0.20.10 > GNOME Control Center-3.2.2 > > as opposed to > > gnome-keyring-3.4.1 > gnome-shell-3.2.1 > gnome-themes-standard-3.4.1 > > My preference is that the title match the package file name. That is, > instead > of 'GNOME Desktop-3.4.1', we use 'gnome-desktop-3.4.1'. > > The only thing that would need to be changed is the <title></title> on the > affected pages. > > What do you think? I think the book is to be read by humans so I've been moving towards capitalising the words and removing dashes from the titles. Eg, I'd prefer it was written Gnome Desktop 3.4.1. But I can see your point, the index does look odd with some things capitalised and others not. If we settled on having the <title></title> as the package name (based the tarball name?) I could live with that. Andy -- http://linuxfromscratch.org/mailman/listinfo/blfs-dev FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
