Re: prompts in command examples

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

 



On Wed, Oct 01, 2008 at 09:32:22PM -0400, Matthew Daniels wrote:
> I'm pretty happy with the original proposal.  The prompt character makes 
> sense if you're copying and pasting console output to demonstrate a 
> point, but if you're advising a person to execute a command, the prompt 
> isn't necessary.  The idea that it should be in a prompt is relayed 
> through context.

I agree.

However, we shouldn't have users scratching their heads about what's
run by root and what's not.  Instead, use the following text:

'''
To restart the iptables firewall, run the following command.  Provide
the password for the root account at the prompt.

  su -c '/sbin/service iptables restart'

'''

Note that the su command removes the need for the user to look for
niggling prompt details.  It also clarifies that the user should
expect a prompt for the root password.

-- 
Paul W. Frields                                http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
  http://redhat.com/   -  -  -  -   http://pfrields.fedorapeople.org/
  irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug

Attachment: pgpwN86MKN5Bv.pgp
Description: PGP signature

-- 
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