All of lore.kernel.org
 help / color / mirror / Atom feed
From: Patrick Strasser <patrick.strasser@tugraz.at>
To: grub-devel@gnu.org
Cc: help-grub@gnu.org
Subject: Re: Full documentation for GRUB2
Date: Tue, 29 Mar 2011 17:19:09 +0200	[thread overview]
Message-ID: <imst9c$qmh$1@dough.gmane.org> (raw)
In-Reply-To: <239CEBDEE83EB949A48B6DB812AA19F602C47A30@ex2.zuv.uni-muenchen.de>

schrieb Treutwein Bernhard am 2011-03-24 16:06:
> Hi Bill & Robert,
> 
> [...]
>>> Is there some complete official documentation of GRUB2, or is GRUB2 full
>>> documentation only in source code?;-)
>>
>> I think the Grub2 developers would welcome volunteers to help write
>> documentation.
> 
> this is kind of a hen & egg problem.
> 
> I have no idea how I can find out how to use modules where I 
> have to guess how to use them. There was a nice remark on
> by phcoder on the request list that there are usb mass storage
> and uhci & ehci modules, which I tried and I was able to confirm
> that insmod'ing uhci.mod and usbms.mod on a system, which is not
> able to boot via bios from usb, enabled this system to boot
> from usb by chainloading (usb0)+1. But it is very time consuming
> and frustrating to experiment with different modules just for 
> documentation.

I had a simmilar experience regarding the loopback system - which is by
itself really great. The manual gives a hint of the command, but no
description and no example. I got some working examples from Ubuntu
[ubuntu] and from pendrivelinux.com [pendrive:0][pendrive:1], but no
documentation.

From my experience it's not working to get some newbies or helpers to
write docs. It's the developers task and skill to document features.
Others can then edit this information into nice manuals and spice it
with examples (which they can figure out easily with the raw docs).

Moreover googling is no alternative to proper documentation.
I'd like to contribute examples that I found to the grub docs, but the
manual gives no hint how to do so... ;-)

Patrick


[ubuntu] https://help.ubuntu.com/community/Grub2
[pendrive:0]http://www.pendrivelinux.com/boot-multiple-iso-from-usb-via-grub2-using-linux/
[pendrive:1] http://pendrivelinux.com/downloads/multibootlinux/grub.cfg
Engineers motto: cheap, good, fast: choose any two
Patrick Strasser <patrick dot strasser at student dot tugraz dot at>
Student of Telemati_cs_, Techn. University Graz, Austria



  parent reply	other threads:[~2011-03-29 15:50 UTC|newest]

Thread overview: 24+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-03-24 15:06 Full documentation for GRUB2 Treutwein Bernhard
2011-03-24 18:32 ` kf
2011-03-26  7:03 ` Jordan Uggla
2011-03-29 15:19 ` Patrick Strasser [this message]
2011-03-29 15:58   ` Chris Murphy
2011-03-31  6:19     ` Bruce Dubbs
2011-03-31  9:20     ` Vladimir 'φ-coder/phcoder' Serbinenko
2011-03-29 17:09   ` Colin Watson
2011-03-30  1:18     ` Leslie Rhorer
2011-03-30  1:28       ` Vladimir 'φ-coder/phcoder' Serbinenko
2011-03-30  1:57       ` Bruce Dubbs
2011-03-30  2:01       ` Isaac Dupree
2011-03-30  2:25       ` Colin Watson
2011-03-31  1:15         ` Leslie Rhorer
2011-03-31  7:51           ` Colin Watson
2011-03-31 13:59             ` richardvoigt
2011-03-31 14:24               ` Colin Watson
2011-04-01 10:42             ` Robert Wolf
2011-04-06 14:12               ` Treutwein Bernhard
2011-03-31  8:39           ` Isaac Dupree
2011-03-31  8:58             ` Vladimir 'φ-coder/phcoder' Serbinenko
2011-03-31 10:21             ` Colin Watson
2011-03-31 11:22     ` Patrick Strasser
     [not found] <239CEBDEE83EB949A48B6DB812AA19F60124B386@ex2.zuv.uni-muenchen.de>
2011-04-08  9:21 ` Treutwein Bernhard

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='imst9c$qmh$1@dough.gmane.org' \
    --to=patrick.strasser@tugraz.at \
    --cc=grub-devel@gnu.org \
    --cc=help-grub@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.