Gentoo Archives: gentoo-doc

From: Sven Vermeulen <swift@g.o>
To: gentoo-doc@l.g.o
Subject: Re: [gentoo-doc] Why do we run all commands as root in docs?
Date: Tue, 06 Sep 2005 17:52:48
Message-Id: 20050906175413.GC11476@gentoo.org
In Reply to: [gentoo-doc] Why do we run all commands as root in docs? by "Łukasz Damentko"
1 On Tue, Sep 06, 2005 at 02:28:58PM +0200, Łukasz Damentko wrote:
2 > Now situation looks really strange. We encourage users not to use root
3 > account in security docs, but all over our place, in every code
4 > listing, we have root prompt ("#") which suggests users to use that
5 > account to perform all the actions.
6 >
7 > My idea is that we should use "$" - user prompt - whereever command can
8 > be or should be run as normal user.
9
10 Like Xavier said, most documents have ~# or # because they talk about
11 configuration settings. However, when possible, we should indeed use ~$ or $
12 instead.
13
14 Wkr,
15 Sven Vermeulen
16
17 --
18 Gentoo Foundation Trustee | http://foundation.gentoo.org
19 Gentoo Documentation Project Lead | http://www.gentoo.org/proj/en/gdp
20 Gentoo Council Member
21
22 The Gentoo Project <<< http://www.gentoo.org >>>

Replies

Subject Author
Re: [gentoo-doc] Why do we run all commands as root in docs? Jonathan Smith <smithj@g.o>