From Fedora Project Wiki

< Docs‎ | Drafts

m (1 revision(s))
m (Fixed template)
Line 1: Line 1:
<pre>#!html
{{Draft}}
<font size="+1"></pre>
= Command Line Survival Guide =
= Command Line Survival Guide =
<pre>#!html
</font></pre>
{| border="1"
|-
| {{Template:Warning}} '''THIS IS A DRAFT ONLY, FOR USE BY DOCUMENTATION WRITERS AND EDITORS. DO NOT RELY ON IT FOR ANY ADVICE UNTIL THIS NOTICE DISAPPEARS AND THE DOCUMENT IS PUBLISHED AS FINAL.'''
|}


'''Documentation Summary:'''
'''Documentation Summary:'''
Line 21: Line 13:


''Lead Writer'': JamesMcElhannon
''Lead Writer'': JamesMcElhannon
--------


There are 5 chapters shown below, with the sections numbered.  The
There are 5 chapters shown below, with the sections numbered.  The
Line 40: Line 30:
during the writing of the rest of the text.  Any redundant operations
during the writing of the rest of the text.  Any redundant operations
shown during the Scenarios would be candidates.
shown during the Scenarios would be candidates.


== Sections ==
== Sections ==
Line 51: Line 40:
* [[Docs/Drafts/CommandLineSurvivalGuide/CommonlyUsedCommands]]  
* [[Docs/Drafts/CommandLineSurvivalGuide/CommonlyUsedCommands]]  
* [[Docs/Drafts/CommandLineSurvivalGuide/Tools]]  
* [[Docs/Drafts/CommandLineSurvivalGuide/Tools]]  


== Summary of Sections ==
== Summary of Sections ==
Line 141: Line 129:


Concepts:
Concepts:
1. Understanding the Command-line Environment
# Understanding the Command-line Environment
1. Running Commands
# Running Commands
1. How Logging Works
# How Logging Works
1. Automating Commands as Scripts
# Automating Commands as Scripts
1. Understanding Linux Security
# Understanding Linux Security
1. Connecting Commands Together
# Connecting Commands Together
1. Discovering Commands
# Discovering Commands
1. Customizing Your Command-line Environment
# Customizing Your Command-line Environment


Section 7 doesn't appear in your ToC - the idea is that if you explain
Section 7 doesn't appear in your ToC - the idea is that if you explain

Revision as of 17:48, 3 June 2008

Warning.png
This page is a draft only
It is still under construction and content may change. Do not rely on the information on this page.

Command Line Survival Guide

Documentation Summary:

Purpose: Document describing theory of the command line and how to perform common tasks.

Audience: Novice end-users needing to use the command line.

Assumptions: The reader has access to a Fedora installation, but no particular type may be assumed. The reader has a user account with the default settings. The reader may have access to the root password.

Related Documents: not yet sure...

Lead Writer: JamesMcElhannon

There are 5 chapters shown below, with the sections numbered. The Concepts chapter sets forth just enough theory to be able to use the commands below.

The Scenario chapter would put forth some common scenarios that people would be faced with. The text would describe the usage of a set of commands to perform a task, cross referenced to the Commonly Used Commands section.

The Commonly Used Commands would not be a reproduction of the man pages, but would instead focus on the common usage of the command.

The Tools would section would be brief scripts to make some things easier. I would expect that the details of this section would arise during the writing of the rest of the text. Any redundant operations shown during the Scenarios would be candidates.

Sections

Pages for individual chapters:

Summary of Sections

Brief descriptions of the chapters:

Introduction

  • General introduction

Concepts

  • Shells
  • Executables and Processes
  • stdout, stderr, stdin
  • Scripts
  • Permissions
  • Redirection and Pipes
  • Bash prompt customization

Scenarios

  • Handling zip/gz files
  • Handling tar files
  • ...

Commonly Used Commands

  • basename
  • bash
  • bunzip
  • bzip
  • cd
  • chgrp
  • chmod
  • chown
  • clear
  • cp
  • cut
  • echo
  • expr
  • find
  • finger
  • grep
  • gunzip
  • gzip
  • head
  • hostname
  • info
  • kill
  • ln
  • ls
  • man
  • mkdir
  • more
  • mv
  • ping
  • popd
  • ps
  • pushd
  • rm
  • rmdir
  • rpm
  • set
  • stty
  • su
  • sudo
  • tail
  • tar
  • test []
  • traceroute
  • uname
  • wait
  • wc
  • where
  • who am i
  • whoami

Tools

  • echodo
  • ...

Feedback from StuartEllis 2006-05-01

This is a very general suggestion - it may be helpful to phrase the "Concepts" headings in terms of tasks, since a new user may not strongly associate the technical features with what they actually do. Some features also relate to more one technology, e.g. a new user who has just read about permissions may be puzzled by "permission denied" messages unless there is at least a mention of SELinux.

This example is just off the top of my head:

Concepts:

  1. Understanding the Command-line Environment
  2. Running Commands
  3. How Logging Works
  4. Automating Commands as Scripts
  5. Understanding Linux Security
  6. Connecting Commands Together
  7. Discovering Commands
  8. Customizing Your Command-line Environment

Section 7 doesn't appear in your ToC - the idea is that if you explain how to discover useful commands, you could focus on only describing a small set of commands yourself, with a clean conscience, rather than feeling obliged to select and cover many. Teach 'em how to fish  :) .

The GNOME desktop help browser in FC5 displays man and info documentation, so the documentation for the hundreds of commands on the system is accessible, but a new user may need pointers to how to locate what they need. The apropos command also enables users to find the right utility, once they are aware of it.