Hi, i have just reviewed the handbook and there appeared some questions to me i'd like to discuss. 1.) It looks like the docbook version of the handbook has not been updated for some time. Do we want to drop the docbook version and only maintain the wiki page? This eases the maintenance, but on the other site we only have the html and the txt view. 2.) Regarding a fakeroot advice in the handbook: should i merge the existing FakerootPorts wiki page with the handbook or do we want to keep this page. I suggest the second way: Only a short hint in the handbook refering to the detailed wiki page. 3.) Another idea i have is to add an advice to prtverify in the "Package Guidelines"-section. What do you think? 4.) The "Supported Hardware"-section: Will there still be an i586 image for 2.3? And what changes were made for the included drivers? 5.) Last question: What is the "setup-chroot" command for? Regards, Till -- http://www.tbmnet.de ___________________________________________________________ Der frühe Vogel fängt den Wurm. Hier gelangen Sie zum neuen Yahoo! Mail: http://mail.yahoo.de
On Sat, Feb 24, 2007 at 11:31:26AM +0100, Till Biedermann wrote:
1.) It looks like the docbook version of the handbook has not been updated for some time. Do we want to drop the docbook version and only maintain the wiki page? This eases the maintenance, but on the other site we only have the html and the txt view.
Yes, the docbook version is no longer used, and I think the print version from the wiki is nice enough if we want to convert it as pdf: http://crux.nu/~sip/test/hb23.pdf
2.) Regarding a fakeroot advice in the handbook: should i merge the existing FakerootPorts wiki page with the handbook or do we want to keep this page. I suggest the second way: Only a short hint in the handbook refering to the detailed wiki page.
3.) Another idea i have is to add an advice to prtverify in the "Package Guidelines"-section. What do you think?
I suggest we add a "good practices" or "useful tools" chapter to introduce things like prtverify (prt-utils in general), fakeroot.
5.) Last question: What is the "setup-chroot" command for?
does the following: $ mount --bind /dev /mnt/dev $ mount --bind /tmp /mnt/tmp $ mount -t proc proc /mnt/proc $ mount -t sysfs none /mnt/sys $ chroot /mnt /bin/bash It's meant as a shortcut for the most boring part of an installation, but I think we should keep both options documented in the handbook. -- Simone Rota Bergamo, Italy - http://www.varlock.com
Simone Rota wrote:
On Sat, Feb 24, 2007 at 11:31:26AM +0100, Till Biedermann wrote:
2.) Regarding a fakeroot advice in the handbook: should i merge the [...]
I suggest we add a "good practices" or "useful tools" chapter to introduce things like prtverify (prt-utils in general), fakeroot.
I added section 5.2.6 named "Additional tools", with a subsection for fakeroot and a paragraph for prt-utils.
5.) Last question: What is the "setup-chroot" command for? [....]
It's meant as a shortcut for the most boring part of an installation, but I think we should keep both options documented in the handbook.
I added an advice in form of a "note". The same note could be added in the "Upgrading From CD-ROM" section, but i think it's enough when it's mentioned once. So, i'm through with the review. When there are no objections i'll close task #151. Regards, Till -- http://www.tbmnet.de ___________________________________________________________ Telefonate ohne weitere Kosten vom PC zum PC: http://messenger.yahoo.de
On Sat, Feb 24, 2007 at 11:31:26AM +0100, Till Biedermann wrote:
Hi,
Hello Till, [...]
4.) The "Supported Hardware"-section: Will there still be an i586 image for 2.3?
Yes, I'll contribute one. regards Jürgen -- Juergen Daubert | mailto:jue@jue.li Korb, Germany | http://jue.li/crux
I have added the new network configuration with iproute2. Is this now the definite standard? In case "yes" the old ifconfig-commands could be removed, or should they be kept? Maybe it makes sense to add a note about the new commands for upgrades. What do you think? Regards, Till -- http://www.tbmnet.de ___________________________________________________________ Telefonate ohne weitere Kosten vom PC zum PC: http://messenger.yahoo.de
participants (3)
-
Juergen Daubert -
Simone Rota -
Till Biedermann