List Info

Thread: Linking to information contained in not yet installed files




Linking to information contained in not yet installed files
country flaguser name
United States
2008-03-11 15:31:09
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=notfredunaffiliated/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</rep
laceable>/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"/&
gt;.
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://fedorapro
ject.org/wiki/KernelCommonProblems#head-5880fcaae620309a0c00
f6778726b632819bab1a
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=jonfedora/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-parame
ters.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=jonfedora/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://fedora
project.org/wiki/BobJensen

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


[1]

about | contact  Other archives ( Real Estate discussion Medical topics )