Difference between revisions of "Help:Style"

From ArchWiki
Jump to: navigation, search
(the creation of this page has been authorized here)
 
(this is based on Help:Reading, so ti does not require an initial discussion)
Line 11: Line 11:
 
*You are warmly invited to discuss your additions or modifications in the [[Help_talk:Style|talk page]], before submitting them; you can also start discussions in the [https://bbs.archlinux.org/viewforum.php?id=13 forum], but you should add a link to the thread in the talk page anyway.
 
*You are warmly invited to discuss your additions or modifications in the [[Help_talk:Style|talk page]], before submitting them; you can also start discussions in the [https://bbs.archlinux.org/viewforum.php?id=13 forum], but you should add a link to the thread in the talk page anyway.
 
}}
 
}}
 +
 +
==Commands: regular user or root==
 +
When writing CLI commands, always make distinction whether each should be issued as a regular user, or as root:
 +
*use <tt>$</tt> for regular user commands:
 +
$ makepkg -s
 +
*use <tt>#</tt> for root commands:
 +
# pacman -S kernel26
 +
 +
{{Note|Since <tt>#</tt> is also used to denote comments in text files, you should always make sure to avoid ambiguities, usually by explicitly writing to run the command or edit a text file.}}

Revision as of 16:25, 5 May 2011

Tango-document-new.pngThis article is a stub.Tango-document-new.png

Notes: please use the first argument of the template to provide more detailed indications. (Discuss in Help talk:Style#)

This page aims to provide a guide for the standardization of style in the articles of this wiki.

Note:
  • This guide is a draft, it has not been officialized yet, and its rules cannot be considered in a definitive status.
  • You are warmly invited to discuss your additions or modifications in the talk page, before submitting them; you can also start discussions in the forum, but you should add a link to the thread in the talk page anyway.

Commands: regular user or root

When writing CLI commands, always make distinction whether each should be issued as a regular user, or as root:

  • use $ for regular user commands:
$ makepkg -s
  • use # for root commands:
# pacman -S kernel26
Note: Since # is also used to denote comments in text files, you should always make sure to avoid ambiguities, usually by explicitly writing to run the command or edit a text file.