Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: Łukasz Damentko <rane@g.o>
Subject: Why do we run all commands as root in docs?
Date: Tue, 6 Sep 2005 14:28:58 +0200
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Greetings,

I'm not filing a bug but writing here, because i think that this case
needs policy change and some discussion in the team before that as it
will lead to really lots of fixing in our docs.

Now situation looks really strange. We encourage users not to use root
account in security docs, but all over our place, in every code
listing, we have root prompt ("#") which suggests users to use that
account to perform all the actions.

My idea is that we should use "$" - user prompt - whereever command can
be or should be run as normal user.

Example?

http://www.gentoo.org/proj/en/gdp/doc/doc-tipsntricks.xml:

# wget http://www.gentoo.org/dyn/doc-snapshots/docs-latest-en.tar.bz2

Why we should download it as root? Why not just:

$ wget http://www.gentoo.org/dyn/doc-snapshots/docs-latest-en.tar.bz2?

For me, it could reduce bad behaviour of doing simple commands as root,
which is not needed and should be avoided as much as possible.

Of course i know that when all our docs contain such prompts, fixing it
would cost lots of resources and can accept if you refuse due to that.

I also know that users don't have to be informed what those strange
prompt signs (#, $) mean, but that can be easily solved with small note
in index.xml files.

I'm waiting for your opinions. 

with kind regards,

Łukasz Damentko

(who bought many extra fingers already)
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (GNU/Linux)

iD8DBQFDHYuK8rb4OBjOeLMRAo/DAJ9++5fJLIGR02IKH0aH0f91RzEG3QCfUrD0
+m1wLfxNN11FYleh9Rd+998=
=D2Pn
-----END PGP SIGNATURE-----
-- 
gentoo-doc@g.o mailing list


Replies:
Re: Why do we run all commands as root in docs?
-- Sven Vermeulen
Re: Why do we run all commands as root in docs?
-- Xavier Neys
Re: Why do we run all commands as root in docs?
-- Shyam Mani
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Questions on a new SPARC doc
Next by thread:
Re: Why do we run all commands as root in docs?
Previous by date:
Re: Questions on a new SPARC doc
Next by date:
Re: Why do we run all commands as root in docs?


Updated Oct 31, 2011

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.