Bug#401233: debian-installer-manual: how to get the guide source should be clarified
reopen 40123 ! thanks On Sat, 02 Dec 2006 11:05:22 +0100 Frans Pop wrote: On Saturday 02 December 2006 00:59, Francesco Poli wrote: It's not clear to me how to get the source for the Debian Installation Guide. For the Sarge version: apt-get source debian-installer For the Etch version: apt-get source installation-guide In both cases you could have found out by looking at the packages.debian.org website as that lists which source package each normal package belongs to. http://packages.debian.org/stable/devel/debian-installer-manual http://packages.debian.org/testing/doc/installation-guide-i386 [...] Apologies for not being clear enough. Let's try to explain things better... The problem is *not* that the source for the stable version of the manual is not distributed: it is, and that's OK. Hence the wishlist severity of the bug. The problem is: figuring out where to get the source by looking at the webpage[1] is not made easy. In that page[1] there are links for a great number of compiled versions of the manual, but no direct link the the source. I searched inside the page and found no hints. I found hints to use the subversion repository elsewhere, tried to dig the WebSVN interface and got lost. Only *then* I remembered that the manual is also packaged and thus found the source tar archive[2]. I could have been smarter in the first place, I admit it's my poor brain's fault, but anyway why not making things easier? I've been using Debian since 2002 and I don't consider myself a totally inexperienced user. Just imagine some casual Gordon Gpllover that knows little about Debian and wants (for reasons unknown) to redistribute a PDF version of the stable Debian installation guide. He does *not* know that the manual is also packaged: he finds the webpage[1] and downloads the PDF. He reads that the guide is under the GNU GPL and thus knows that he must make the source available in order to redistribute it (Gordon knows little about Debian, but is quite familiar with the GNU GPL license!). In this scenario, a little link to the tar archive[2] from the webpage[1] would do the trick and make Gordon's life much easier... I hope I clarified what I meant. [1] http://www.debian.org/releases/stable/installmanual [2] http://ftp.debian.org/debian/pool/main/d/debian-installer/debian-installer_20050317sarge1.tar.gz -- But it is also tradition that times *must* and always do change, my friend. -- from _Coming to America_ . Francesco Poli . GnuPG key fpr == C979 F34B 27CE 5CD8 DC12 31B5 78F4 279B DD6D FCF4 pgp4HT7xzRjk6.pgp Description: PGP signature
Bug#401233: debian-installer-manual: how to get the guide source should be clarified
reopen 401233 ! thanks On Sat, 2 Dec 2006 15:50:02 +0100 Francesco Poli wrote: reopen 40123 ! ^^^ thanks [...] Let's see if this time I manage to reopen the right bug! :-/ I hope I didn't reopen a very old bug by mistake: http://bugs.debian.org/40123 gives the following error message: | | There is no record of Bug #40123. Try the search page instead. | And the BTS replied to me: | | reopen 40123 ! | Bug number 40123 not found. (Is it archived?) | Consequently it seems to me that I didn't reopen anything with my previous messed up control request... -- But it is also tradition that times *must* and always do change, my friend. -- from _Coming to America_ . Francesco Poli . GnuPG key fpr == C979 F34B 27CE 5CD8 DC12 31B5 78F4 279B DD6D FCF4 pgph27I4gaZUb.pgp Description: PGP signature
Processed: Re: Bug#401233: debian-installer-manual: how to get the guide source should be clarified
Processing commands for [EMAIL PROTECTED]: reopen 401233 ! Bug#401233: debian-installer-manual: how to get the guide source should be clarified Bug reopened, originator set to Francesco Poli [EMAIL PROTECTED]. thanks Stopping processing here. Please contact me if you need assistance. Debian bug tracking system administrator (administrator, Debian Bugs database) -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]
Bug#401233: debian-installer-manual: how to get the guide source should be clarified
On Sat, 02 Dec 2006 16:35:33 +0100 Frans Pop wrote: On Saturday 02 December 2006 15:50, Francesco Poli wrote: The problem is: figuring out where to get the source by looking at the webpage[1] is not made easy. In that page[1] there are links for a great number of compiled versions of the manual, but no direct link the the source. Then you should probably look inside the manual itself, specifically: http://www.debian.org/releases/stable/i386/apds02.html.en That is good for learning how to get the latest development version. But if one wants the source for the published stable version, well, it does not seem easy... I agree that for Sarge it is then still quite hard to make the link to the manual, but for Etch, where the manual has its own source package, I'd expect people to be able to find it. As I said, being aware that the manual is *actually* packaged in a .deb package is not trivial. *You* can perceive it as obvious, *I* can know it (even if, as I told you previously, I had forgotten it for a while...), but many people (especially those who are coming from some other distros, or from proprietary OSes) won't understand that immediately... If not, they can always ask on the debian-boot list. Finding the address for that should be no problem. Why not making things clearer, rather than being prepared to answer questions on mailing lists? Once again, new users can be too shy to pop up on a mailing list... Adding a link to the tarbal is next to impossible as it would have to include a changing version number. What do you mean? I'm talking about the published stable version of the manual: it's been the same exact version since June 2005 so far (or am I wrong?). Adding a simple link should not be difficult... I honestly see no reason to add the info on the website. I think I described more than one reason to do so... -- But it is also tradition that times *must* and always do change, my friend. -- from _Coming to America_ . Francesco Poli . GnuPG key fpr == C979 F34B 27CE 5CD8 DC12 31B5 78F4 279B DD6D FCF4 pgpi4Pxhoujxt.pgp Description: PGP signature
Bug#401233: debian-installer-manual: how to get the guide source should be clarified
On Saturday 02 December 2006 18:27, Francesco Poli wrote: I'm talking about the published stable version of the manual: it's been the same exact version since June 2005 so far (or am I wrong?). Yes, you are wrong. Cheers, FJP -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]
Bug#401233: debian-installer-manual: how to get the guide source should be clarified
On Sat, 02 Dec 2006 19:02:55 +0100 Frans Pop wrote: On Saturday 02 December 2006 18:27, Francesco Poli wrote: I'm talking about the published stable version of the manual: it's been the same exact version since June 2005 so far (or am I wrong?). Yes, you are wrong. Could you be a little more explicit? Are you referring to point releases? -- But it is also tradition that times *must* and always do change, my friend. -- from _Coming to America_ . Francesco Poli . GnuPG key fpr == C979 F34B 27CE 5CD8 DC12 31B5 78F4 279B DD6D FCF4 pgpx3Rec2ajaH.pgp Description: PGP signature
Bug#401233: debian-installer-manual: how to get the guide source should be clarified
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Frans Pop wrote: On Saturday 02 December 2006 18:27, Francesco Poli wrote: I'm talking about the published stable version of the manual: it's been the same exact version since June 2005 so far (or am I wrong?). Yes, you are wrong. If by wrong you mean point releases and minor updates have been done since the release of Sarge, that is really irrelevant, the link could have stayed the same. And if it didn't, I am sure it can be done somehow in a way to not need manual updates at each point release. Francesco is right, IMO. There should be an *obvious* link to the source. Also, more importantly, there should always be links to other variants of this document - like PDF, PS, single page HTML, since they prove to be really useful for offline use and, sometimes, online use (I almost always prefer the single page variant since it allows easier searching). - -- Regards, EddyP = Imagination is more important than knowledge A.Einstein -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.5 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iD8DBQFFciwWY8Chqv3NRNoRAqayAJ0SuoUeBbPEgED6S56O6K/3qY8DOACgj2cK EA/O39Ml0v5ee71srFcejxg= =0RV7 -END PGP SIGNATURE- -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]
Bug#401233: debian-installer-manual: how to get the guide source should be clarified
Package: debian-installer-manual Severity: wishlist Hi! It's not clear to me how to get the source for the Debian Installation Guide. At the Debian Documentation Project page[1], there's a Subversion command line that will probably checkout the latest development version (right?). This seems OK. But the published version for the stable release[2] does not tell any method to get source for that version. I think it should made easy to get the source for the published version of the guide, ideally with a link to a good (gzipped or bzipped2) tar archive of the complete source. I tried to browse through the WebSVN interface, but I quickly got lost... :-( After some failed tries, I figured out that I could get the source package of debian-installer-manual (sarge version), but it's not really clear to me whether this is the same exact version as the one published for the stable release[2]... Is it the same? In any case, I think that a good link in the webpage[2] would really make things easier (especially for users that lack enough familiarity with Debian). Can we have this fixed for the next stable release (etch), please? Thanks for your attention. [1] http://www.debian.org/doc/user-manuals#install-sarge [2] http://www.debian.org/releases/stable/installmanual -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]
