Linking to information contained in not yet installed files

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Below is a log snip from an IRC conversation trying to come up with an idea to get information to users who do not yet have an installed system.


20080311:14:58:32 <EvilBob> Current Book, install-guide - Current File, adminoptions.xml - Gobby --> hamshack.bobjensen.com (until we get our ducks in a row) the second added tip "Kernel Boot Options" 20080311:14:59:24 <EvilBob> what is the best way to deal with this file, the reader will not yet have a running system to have this file
20080311:15:02:43 *     tombolinux has quit ("Ciaoo")
20080311:15:03:34 * Southern_Gentlem (n=notfred@unaffiliated/southerngentlem/x-2894754) has joined #fedora-docs
20080311:15:03:56 <EvilBob>       <tip>
20080311:15:03:56 <EvilBob>         <title>Kernel Boot Options</title>
20080311:15:03:56 <EvilBob>         <para>
20080311:15:03:56 <EvilBob> The full list of kernel options is in the file 20080311:15:03:56 <EvilBob> /usr/share/doc/kernel-doc-<replaceable>version</replaceable>/Documentation/kernel-parameters.txt, 20080311:15:03:56 <EvilBob> which is installed with the kernel-doc package.
20080311:15:03:56 <EvilBob>         </para>
20080311:15:03:56 <EvilBob>       </tip>
20080311:15:04:49 <quaid> they won't yet have that file at this point in the guide?
20080311:15:04:55 <EvilBob>     right
20080311:15:05:40 <EvilBob> 1.) should we publish this with the guide, 2.) publish it externally to the guide? 20080311:15:05:56 <quaid> ok, the challenge is ... if we link out to it, we have something new to maintain 20080311:15:06:12 <quaid> at least if it's in the guide, we can update it for each release
20080311:15:06:18 <EvilBob>         <para>
20080311:15:06:18 <EvilBob> The anaconda installer has many boot options, most are listed on 20080311:15:06:18 <EvilBob> the wiki <ulink url="http://fedoraproject.org/wiki/Anaconda/Options"/>.
20080311:15:06:18 <EvilBob>         </para>
20080311:15:06:21 <quaid> (specifying where it came from leaves us a clue to follow)
20080311:15:06:27 <quaid>       right, like that
20080311:15:06:33 <quaid>       is someone maintaining Anaconda/Options?
20080311:15:06:36 <quaid>       we hope so ...
20080311:15:06:40 <EvilBob>     that is owned by anaconda
20080311:15:06:48 <Southern_Gentlem> you have to assume that they are reading the guide to install so no have the file 20080311:15:06:52 <quaid> Anaconda/Options (last edited 2008-02-14 06:11:21 by JoelGranados)
20080311:15:06:54 <EvilBob>     I got the link from jeremy so I hope so
20080311:15:06:55 <quaid>       ok, that's good
20080311:15:07:26 <EvilBob> http://fedoraproject.org/wiki/KernelCommonProblems#head-5880fcaae620309a0c00f6778726b632819bab1a 20080311:15:07:41 <EvilBob> that is where I grabbed the kernel options info
20080311:15:08:09 <quaid>       ok, hmm
20080311:15:08:30 <quaid> let's copy and paste the list from kernel-parameters.txt into a CDATA block
20080311:15:08:34 <quaid>       makes it easy to maintain, etc.
20080311:15:08:38 <quaid>       and publish that
20080311:15:08:39 <quaid>       ?
20080311:15:09:50 <quaid> heh, kernel-doc isn't installed by default anyway
20080311:15:09:50 <EvilBob>     it is ~100 pages
20080311:15:09:53 *     jmtaylor is now known as jmtaylor_afk
20080311:15:09:55 <quaid>       wow
20080311:15:10:12 <quaid>       appendix?  heh heh
20080311:15:10:15 <EvilBob>     LOL
20080311:15:10:42 <quaid>       could we link to the cvsview?
20080311:15:10:53 <EvilBob>     only 63K
20080311:15:11:20 <EvilBob>     We should be able to but that is new to me
20080311:15:12:36 <EvilBob> Or do we craft a "common" kernel options page that links to the installed kernel-doc file?
20080311:15:12:58 <quaid>       the problem is the versioning
20080311:15:12:58 <EvilBob> that is something we should really have anyhow IMO 20080311:15:13:06 <Southern_Gentlem> quaid, it seems it is not i just had to install it 20080311:15:13:20 <quaid> the doc might be different for each version of the kernel 20080311:15:13:22 <EvilBob> Southern_Gentlem: it is not installed by default
20080311:15:13:34 <Southern_Gentlem>    thats what i am saying
20080311:15:13:38 <quaid>       me too!
20080311:15:13:52 <quaid>       at 3.0 MiB I can understand why
20080311:15:14:14 * daMaestro (n=jon@fedora/damaestro) has joined #fedora-docs
20080311:15:14:25 <EvilBob>     One way to find out, I will ask cebbert
20080311:15:14:35 <EvilBob>     if the doc changes
20080311:15:15:54 <stickster> We don't want to put that doc in the Installation Guide, definitely a link.
20080311:15:16:15 <Southern_Gentlem>    +1 stickster
20080311:15:16:21 <stickster> Unless someone wants to go through the whole "how do we put GPL-licensed stuff in an OPL doc" issue again.
20080311:15:16:24 *     daMaestro has quit (Client Quit)
20080311:15:16:33 <stickster>   Speaking for myself, no thanks.
20080311:15:16:39 <quaid>       oh, right
20080311:15:17:21 <EvilBob>     yeah +1 from me
20080311:15:18:35 <EvilBob> well I will let this rest for now the way we have it, broken as it is IMO, I have pinged cebbert and will ping Dave Jones next time i see him until I get an answer of some sort.
20080311:15:19:09 <Southern_Gentlem>    ping linville as well
20080311:15:19:10 <quaid>       right
20080311:15:19:21 <quaid> next best would be if they would agree to maintain a page such as Kernel/Parameters 20080311:15:19:33 <quaid> that can link out to some kernel.org page or something
20080311:15:19:36 <EvilBob>     Yeah
20080311:15:20:02 <EvilBob>     for the record
20080311:15:20:03 <EvilBob> <EvilBob> cebbert: working on the install guide, looking at /usr/share/doc/kernel-doc-2.6.24/Documentation/kernel-parameters.txt we are wondering if that list is static enough to create a "common options" page to go along with the anaconda page http://fedoraproject.org/wiki/Anaconda/Options
20080311:15:20:28 <EvilBob>     that should get the ball rolling
20080311:15:21:16 <EvilBob> Southern_Gentlem: I will ask John if I do not get anything from jones and cebbert in the next day 20080311:15:21:23 * daMaestro (n=jon@fedora/damaestro) has joined #fedora-docs 20080311:15:22:07 <EvilBob> linville is in the Amateur Radio SIG... brownie points I hope
20080311:15:22:54 *     EvilBob grabs all of this for an email


--

Robert 'Bob' Jensen
http://fedoraproject.org/wiki/BobJensen

--
fedora-docs-list mailing list
fedora-docs-list@xxxxxxxxxx
To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux