Re: prompts in command examples

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



IMHO,
rule 1 = If a normal user can run a command then it must have $ prompt. ex ls -l
rule 2 = If a command need root privilege to run, it must have # prompt   ex dd if=/dev/zero of=/dev/hda
rule3 = rule 1 has high priority then rule 2.

On Thu, Oct 2, 2008 at 3:57 AM, Jason Taylor <jmtaylor90@xxxxxxxxx> wrote:
On Thu, 2008-10-02 at 08:17 +1000, Murray McAllister wrote:
> Hi,
>
> The Red Hat documentation team recently had a discussion about using
> prompts (such as "$" and "#") in command examples.
>
> Joshua "top-posting ftw" Wulf came up with the following, and everyone
> agreed (I think...):
>
> ---
>
> OK, here it is:
>
> When it's a command that should (could) be cut and pasted, it should
> have no prompt. Example:
>
> ls -Z /tmp
>
> When it's a record of an interactive session then the prompt should be
> included to distinguish commands from output. Example:
>
> # ls -Z /tmp
>
> -rw-rw-r--  auser   auser   user_u:object_r:user_home_t   bar
> -rw-rw-r--  auser   auser   user_u:object_r:user_home_t   foo
>
> And when you want to make some commentary on that, you close the box
> and then speak.
>
> ---
>
> Does anyone have any suggestions or objections?
>
> Cheers.

Commentary being along the lines of whether or not the command
should/has to be run as root or normal user?

-Jason

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



--
┌───[ Narendra Sisodiya ]──────────────┐
│     http://narendra.techfandu.org
│     http://www.lug-iitd.org
└────────────[ +91-93790-75930 ]──────┘
-- 
fedora-docs-list mailing list
fedora-docs-list@xxxxxxxxxx
To unsubscribe: 
https://www.redhat.com/mailman/listinfo/fedora-docs-list

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux