From bob at fedoraunity.org Thu Jun 4 22:16:09 2015 Content-Type: multipart/mixed; boundary="===============5509014728409850888==" MIME-Version: 1.0 From: Robert 'Bob' Jensen To: docs at lists.fedoraproject.org Subject: Linking to information contained in not yet installed files Date: Tue, 11 Mar 2008 15:31:09 -0500 Message-ID: <47D6EC0D.5050405@fedoraunity.org> --===============5509014728409850888== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable 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 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 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=3Dnotfred(a)unaffiliated/southerngentlem/x-2894754) has joined #fedora-d= ocs 20080311:15:03:56 20080311:15:03:56 Kernel Boot Options 20080311:15:03:56 20080311:15:03:56 The full list of kernel options is = in the file 20080311:15:03:56 = /usr/share/doc/kernel-doc-version/Documentation/= kernel-parameters.txt, 20080311:15:03:56 which is installed with the = kernel-doc package. 20080311:15:03:56 20080311:15:03:56 20080311:15:04:49 they won't yet have that file at this = point in the guide? 20080311:15:04:55 right 20080311:15:05:40 1.) should we publish this with the = guide, 2.) publish it externally to the guide? 20080311:15:05:56 ok, the challenge is ... if we link out = to it, we have something new to maintain 20080311:15:06:12 at least if it's in the guide, we can = update it for each release 20080311:15:06:18 20080311:15:06:18 The anaconda installer has many = boot options, most are listed on 20080311:15:06:18 the wiki . 20080311:15:06:18 20080311:15:06:21 (specifying where it came from leaves us = a clue to follow) 20080311:15:06:27 right, like that 20080311:15:06:33 is someone maintaining Anaconda/Options? 20080311:15:06:36 we hope so ... 20080311:15:06:40 that is owned by anaconda 20080311:15:06:48 you have to assume that they are = reading the guide to install so no have the file 20080311:15:06:52 Anaconda/Options (last edited 2008-02-14 = 06:11:21 by JoelGranados) 20080311:15:06:54 I got the link from jeremy so I hope so 20080311:15:06:55 ok, that's good 20080311:15:07:26 = http://fedoraproject.org/wiki/KernelCommonProblems#head-5880fcaae620309a0c0= 0f6778726b632819bab1a 20080311:15:07:41 that is where I grabbed the kernel = options info 20080311:15:08:09 ok, hmm 20080311:15:08:30 let's copy and paste the list from = kernel-parameters.txt into a CDATA block 20080311:15:08:34 makes it easy to maintain, etc. 20080311:15:08:38 and publish that 20080311:15:08:39 ? 20080311:15:09:50 heh, kernel-doc isn't installed by = default anyway 20080311:15:09:50 it is ~100 pages 20080311:15:09:53 * jmtaylor is now known as jmtaylor_afk 20080311:15:09:55 wow 20080311:15:10:12 appendix? heh heh 20080311:15:10:15 LOL 20080311:15:10:42 could we link to the cvsview? 20080311:15:10:53 only 63K 20080311:15:11:20 We should be able to but that is new to me 20080311:15:12:36 Or do we craft a "common" kernel options = page that links to the installed kernel-doc file? 20080311:15:12:58 the problem is the versioning 20080311:15:12:58 that is something we should really have = anyhow IMO 20080311:15:13:06 quaid, it seems it is not i just = had to install it 20080311:15:13:20 the doc might be different for each = version of the kernel 20080311:15:13:22 Southern_Gentlem: it is not installed by = default 20080311:15:13:34 thats what i am saying 20080311:15:13:38 me too! 20080311:15:13:52 at 3.0 MiB I can understand why 20080311:15:14:14 * daMaestro (n=3Djon(a)fedora/damaestro) has joined = #fedora-docs 20080311:15:14:25 One way to find out, I will ask cebbert 20080311:15:14:35 if the doc changes 20080311:15:15:54 We don't want to put that doc in the = Installation Guide, definitely a link. 20080311:15:16:15 +1 stickster 20080311:15:16:21 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 Speaking for myself, no thanks. 20080311:15:16:39 oh, right 20080311:15:17:21 yeah +1 from me 20080311:15:18:35 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 ping linville as well 20080311:15:19:10 right 20080311:15:19:21 next best would be if they would agree = to maintain a page such as Kernel/Parameters 20080311:15:19:33 that can link out to some kernel.org = page or something 20080311:15:19:36 Yeah 20080311:15:20:02 for the record 20080311:15:20:03 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 that should get the ball rolling 20080311:15:21:16 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=3Djon(a)fedora/damaestro) has joined = #fedora-docs 20080311:15:22:07 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 --===============5509014728409850888==--