aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rwxr-xr-xdocs/autodocifier.pl6
-rw-r--r--docs/busybox.pod158
2 files changed, 69 insertions, 95 deletions
diff --git a/docs/autodocifier.pl b/docs/autodocifier.pl
index 9133afb98..2bf7cd8a1 100755
--- a/docs/autodocifier.pl
+++ b/docs/autodocifier.pl
@@ -27,8 +27,8 @@ sub beautify {
my @line = split("\n", $text);
$text = join('',
map {
- s/^\s*//;
- s/"//g;
+ s/^\s*"//;
+ s/"\s*$//;
s/%/%%/g;
s/\$/\\\$/g;
eval qq[ sprintf(qq{$_}) ]
@@ -275,4 +275,4 @@ John BEPPU <beppu@lineo.com>
=cut
-# $Id: autodocifier.pl,v 1.19 2001/04/05 20:03:33 beppu Exp $
+# $Id: autodocifier.pl,v 1.20 2001/04/10 00:00:05 kraai Exp $
diff --git a/docs/busybox.pod b/docs/busybox.pod
index 185d22c05..ca3ce97b5 100644
--- a/docs/busybox.pod
+++ b/docs/busybox.pod
@@ -230,7 +230,7 @@ Changes the foreground virtual terminal to /dev/ttyN
=item B<clear>
-clear
+clear
Clear screen.
@@ -275,9 +275,9 @@ Options:
Example:
- $ echo Hello world | cut -f 1 -d ' '
+ $ echo "Hello world" | cut -f 1 -d ' '
Hello
- $ echo Hello world | cut -f 2 -d ' '
+ $ echo "Hello world" | cut -f 2 -d ' '
world
-------------------------------
@@ -370,7 +370,7 @@ Options:
-h print sizes in human readable format (e.g., 1K 243M 2G )
-m print sizes in megabytes
- -k print sizes in kilobytes(default)
+ -k print sizes in kilobytes(default)
Example:
@@ -472,7 +472,7 @@ Options:
-s display only a total for each argument
-h print sizes in human readable format (e.g., 1K 243M 2G )
-m print sizes in megabytes
- -k print sizes in kilobytes(default)
+ -k print sizes in kilobytes(default)
Example:
@@ -536,17 +536,17 @@ Options:
Example:
- $ echo Erik is cool
+ $ echo "Erik is cool"
Erik is cool
- $ echo -e Erik
+ $ echo -e "Erik
is
- cool
+ cool"
Erik
is
cool
- $ echo Erik
+ $ echo "Erik
is
- cool
+ cool"
Erik
is
cool
@@ -609,7 +609,7 @@ of characters matched or 0.
=item B<false>
-false
+false
Return an exit code of FALSE (1).
@@ -630,7 +630,7 @@ Show and modify frame buffer settings
Example:
$ fbset
- mode 1024x768-76
+ mode "1024x768-76"
# D: 78.653 MHz, H: 59.949 kHz, V: 75.694 Hz
geometry 1024 768 1024 768 16
timings 12714 128 32 16 4 128 4
@@ -675,7 +675,7 @@ Example:
=item B<free>
-free
+free
Displays the amount of free and used system memory
@@ -686,7 +686,6 @@ Example:
Mem: 257628 248724 8904 59644 93124
Swap: 128516 8404 120112
Total: 386144 257128 129016
-
-------------------------------
@@ -715,7 +714,7 @@ Options:
-a Perform automatic repairs
-v verbose
-s Outputs super-block information
- -m Activates MINIX-like mode not cleared warnings
+ -m Activates MINIX-like "mode not cleared" warnings
-f Force file system check.
-------------------------------
@@ -741,20 +740,20 @@ Example:
$ cat getopt.test
#!/bin/sh
GETOPT=`getopt -o ab:c:: --long a-long,b-long:,c-long:: \
- -n 'example.busybox' -- $@`
+ -n 'example.busybox' -- "$@"`
if [ $? != 0 ] ; then exit 1 ; fi
- eval set -- $GETOPT
+ eval set -- "$GETOPT"
while true ; do
case $1 in
- -a|--a-long) echo Option a ; shift ;;
- -b|--b-long) echo Option b, argument `$2' ; shift 2 ;;
+ -a|--a-long) echo "Option a" ; shift ;;
+ -b|--b-long) echo "Option b, argument `$2'" ; shift 2 ;;
-c|--c-long)
- case $2 in
- \) echo Option c, no argument; shift 2 ;;
- *) echo Option c, argument `$2' ; shift 2 ;;
+ case "$2" in
+ "") echo "Option c, no argument"; shift 2 ;;
+ *) echo "Option c, argument `$2'" ; shift 2 ;;
esac ;;
--) shift ; break ;;
- *) echo Internal error! ; exit 1 ;;
+ *) echo "Internal error!" ; exit 1 ;;
esac
done
@@ -830,7 +829,7 @@ Example:
=item B<halt>
-halt
+halt
Halt the system.
@@ -858,7 +857,7 @@ Example:
=item B<hostid>
-hostid
+hostid
Print out a unique 32-bit identifier for the machine.
@@ -926,7 +925,7 @@ Options:
=item B<init>
-init
+init
Init is the parent of all processes.
@@ -960,7 +959,7 @@ If you choose to use an /etc/inittab file, the inittab entry format is as follow
WARNING: This field has a non-traditional meaning for BusyBox init!
The id field is used by BusyBox init to specify the controlling tty for
the specified process to run on. The contents of this field are
- appended to /dev/ and used as-is. There is no need for this field to
+ appended to "/dev/" and used as-is. There is no need for this field to
be unique, although if it isn't you may have strange results. If this
field is left blank, the controlling tty is set to the console. Also
note that if BusyBox detects that a serial console is in use, then only
@@ -1003,7 +1002,7 @@ If you choose to use an /etc/inittab file, the inittab entry format is as follow
it. Unlike sysvinit, BusyBox init does not stop processes from
respawning out of control. The 'askfirst' actions acts just like
respawn, except that before running the specified process it
- displays the line Please press Enter to activate this console.
+ displays the line "Please press Enter to activate this console."
and then waits for the user to press enter before starting the
specified process.
@@ -1023,9 +1022,9 @@ Example /etc/inittab file:
# /bin/sh invocations on selected ttys
#
- # Start an askfirst shell on the console (whatever that may be)
+ # Start an "askfirst" shell on the console (whatever that may be)
::askfirst:-/bin/sh
- # Start an askfirst shell on /dev/tty2-4
+ # Start an "askfirst" shell on /dev/tty2-4
tty2::askfirst:-/bin/sh
tty3::askfirst:-/bin/sh
tty4::askfirst:-/bin/sh
@@ -1104,7 +1103,6 @@ Options:
Example:
$ killall apache
-
-------------------------------
@@ -1127,7 +1125,7 @@ Prints out the length of the specified STRING.
Example:
- $ length Hello
+ $ length "Hello"
5
-------------------------------
@@ -1151,7 +1149,6 @@ Example:
$ ln -s BusyBox /tmp/ls
$ ls -l /tmp/ls
lrwxrwxrwx 1 root root 7 Apr 12 18:39 ls -> BusyBox*
-
-------------------------------
@@ -1164,7 +1161,6 @@ Loads an acm from standard input.
Example:
$ loadacm < /etc/i18n/acmname
-
-------------------------------
@@ -1177,7 +1173,6 @@ Loads a console font from standard input.
Example:
$ loadfont < /etc/i18n/fontname
-
-------------------------------
@@ -1190,7 +1185,6 @@ Loads a binary keyboard translation table from standard input.
Example:
$ loadkmap < /etc/i18n/lang-keymap
-
-------------------------------
@@ -1209,14 +1203,13 @@ Options:
Example:
- $ logger hello
-
+ $ logger "hello"
-------------------------------
=item B<logname>
-logname
+logname
Print the name of the current user.
@@ -1224,13 +1217,12 @@ Example:
$ logname
root
-
-------------------------------
=item B<logread>
-logread
+logread
Shows the messages from syslogd (using circular buffer).
@@ -1269,13 +1261,13 @@ Options:
-x list entries by lines instead of by columns
-X sort the listing by extension
-h print sizes in human readable format (e.g., 1K 243M 2G )
- -k print sizes in kilobytes(default)
+ -k print sizes in kilobytes(default)
-------------------------------
=item B<lsmod>
-lsmod
+lsmod
List the currently loaded kernel modules.
@@ -1308,7 +1300,6 @@ Example:
[creates ttyS2-ttyS63]
$ makedevs /dev/hda b 3 0 0 8 s
[creates hda,hda1-hda8]
-
-------------------------------
@@ -1364,7 +1355,6 @@ Example:
$ mkdir /tmp/foo/bar/baz
/tmp/foo/bar/baz: No such file or directory
$ mkdir -p /tmp/foo/bar/baz
-
-------------------------------
@@ -1416,7 +1406,6 @@ Example:
$ mknod /dev/fd0 b 2 0
$ mknod -m 644 /tmp/pipe p
-
-------------------------------
@@ -1449,7 +1438,6 @@ Example:
/tmp/temp.mWiLjM
$ ls -la /tmp/temp.mWiLjM
-rw------- 1 andersen andersen 0 Apr 25 17:10 /tmp/temp.mWiLjM
-
-------------------------------
@@ -1462,7 +1450,6 @@ More is a filter for viewing FILE one screenful at a time.
Example:
$ dmesg | more
-
-------------------------------
@@ -1475,14 +1462,14 @@ Mount a filesystem
Flags:
-a: Mount all filesystems in fstab.
- -f: Fake Add entry to mount table but don't mount it.
+ -f: "Fake" Add entry to mount table but don't mount it.
-n: Don't write a mount table entry.
-o option: One of many filesystem options, listed below.
-r: Mount the filesystem read-only.
-t fs-type: Specify the filesystem type.
-w: Mount for reading and writing (default).
-Options for use with the B<-o> flag:
+Options for use with the "B<-o>" flag:
async/sync: Writes are asynchronous / synchronous.
atime/noatime: Enable / disable updates to inode access times.
@@ -1504,7 +1491,6 @@ Example:
devpts on /dev/pts type devpts (rw)
$ mount /dev/fd0 /mnt -t msdos -o ro
$ mount /tmp/diskimage /opt -t ext2 -o loop
-
-------------------------------
@@ -1533,13 +1519,12 @@ Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY.
Example:
$ mv /tmp/foo /bin/bar
-
-------------------------------
=item B<nc>
-nc [IP] [port]
+nc [IP] [port]
Netcat opens a pipe to IP:port
@@ -1553,7 +1538,6 @@ Example:
214 NOOP QUIT RSET HELP
quit
221 foobar closing connection
-
-------------------------------
@@ -1571,7 +1555,6 @@ Example:
Name: debian
Address: 127.0.0.1
-
-------------------------------
@@ -1597,7 +1580,6 @@ Example:
--- debian ping statistics ---
1 packets transmitted, 1 packets received, 0% packet loss
round-trip min/avg/max = 20.1/20.1/20.1 ms
-
-------------------------------
@@ -1612,7 +1594,7 @@ the new root file system.
=item B<poweroff>
-poweroff
+poweroff
Halt the system and request that the kernel shut off the power.
@@ -1627,16 +1609,15 @@ Where FORMAT controls the output exactly as in C printf.
Example:
- $ printf Val=%d
- 5
+ $ printf "Val=%d
+ " 5
Val=5
-
-------------------------------
=item B<ps>
-ps
+ps
Report process status
@@ -1660,7 +1641,7 @@ Example:
=item B<pwd>
-pwd
+pwd
Print the full filename of the current working directory.
@@ -1686,7 +1667,7 @@ Options:
=item B<readlink>
-readlink
+readlink
Read a symbolic link.
@@ -1694,7 +1675,7 @@ Read a symbolic link.
=item B<reboot>
-reboot
+reboot
Reboot the system.
@@ -1712,7 +1693,7 @@ from 20 (the process runs only when nothing else is running) to 0
=item B<reset>
-reset
+reset
Resets the screen.
@@ -1798,7 +1779,7 @@ files; if no input files are specified, then the standard input is read.
Example:
- $ echo foo | sed -e 's/f[a-zA-Z]o/bar/g'
+ $ echo "foo" | sed -e 's/f[a-zA-Z]o/bar/g'
bar
-------------------------------
@@ -1831,7 +1812,7 @@ This command does not yet have proper documentation.
Use lash just as you would use any other shell. It properly handles pipes,
redirects, job control, can be used as the shell for scripts, and has a
sufficient set of builtins to do what is needed. It does not (yet) support
-Bourne Shell syntax. If you need things like if-then-else, while, and such
+Bourne Shell syntax. If you need things like "if-then-else", "while", and such
use ash or bash. If you just need a very simple and extremely small shell,
this will do the job.
@@ -1858,12 +1839,12 @@ Sorts lines of text in the specified files
Example:
- $ echo -e e
+ $ echo -e "e
f
b
d
c
- a | sort
+ a" | sort
a
b
c
@@ -1915,7 +1896,7 @@ Options:
=item B<sync>
-sync
+sync
Write all buffered filesystem blocks to disk.
@@ -1985,7 +1966,7 @@ Main operation mode:
File selection:
- f name of tarfile or - for stdin
+ f name of tarfile or "-" for stdin
O extract to stdout
exclude file to exclude
X file with names to exclude
@@ -2013,7 +1994,7 @@ Options:
Example:
- $ echo Hello | tee /tmp/foo
+ $ echo "Hello" | tee /tmp/foo
$ cat /tmp/foo
Hello
@@ -2057,14 +2038,14 @@ Example:
tftp command SOURCE DEST
-Transfers a file from/to a tftp server using octet mode.
+Transfers a file from/to a tftp server using "octet" mode.
Commands:
get Get file from server SOURCE and store to local DEST.
put Put local file SOURCE to server DEST.
-When nameing a server, use the syntax server:file.
+When nameing a server, use the syntax "server:file".
-------------------------------
@@ -2085,7 +2066,6 @@ Example:
$ touch /tmp/foo
$ ls -l /tmp/foo
-rw-rw-r-- 1 andersen andersen 0 Apr 15 01:11 /tmp/foo
-
-------------------------------
@@ -2104,15 +2084,14 @@ Options:
Example:
- $ echo gdkkn vnqkc | tr [a-y] [b-z]
+ $ echo "gdkkn vnqkc" | tr [a-y] [b-z]
hello world
-
-------------------------------
=item B<true>
-true
+true
Return an exit code of TRUE (0).
@@ -2126,7 +2105,7 @@ Example:
=item B<tty>
-tty
+tty
Print the file name of the terminal connected to standard input.
@@ -2181,7 +2160,6 @@ Example:
$ uname -a
Linux debian 2.2.15pre13 #5 Tue Mar 14 16:03:50 MST 2000 i686 unknown
-
-------------------------------
@@ -2200,12 +2178,12 @@ Options:
Example:
- $ echo -e a
+ $ echo -e "a
a
b
c
c
- a | sort | uniq
+ a" | sort | uniq
a
b
c
@@ -2236,7 +2214,7 @@ Options:
=item B<uptime>
-uptime
+uptime
Display the time since the last boot.
@@ -2244,13 +2222,12 @@ Example:
$ uptime
1:55pm up 2:30, load average: 0.09, 0.04, 0.00
-
-------------------------------
=item B<usleep>
-usleep N
+usleep N
Pause for N microseconds.
@@ -2269,14 +2246,13 @@ Uudecode a file that is uuencoded.
Options:
- -o FILE direct output to FILE
+ -o FILE direct output to FILE
Example:
$ uudecode -o busybox busybox.uu
$ ls -l busybox
-rwxr-xr-x 1 ams ams 245264 Jun 7 21:35 busybox
-
-------------------------------
@@ -2308,7 +2284,7 @@ edit FILE.
Options:
- -R Read-only- do not write to the file.
+ -R Read-only- do not write to the file.
-------------------------------
@@ -2338,7 +2314,6 @@ Example:
$ wc /etc/passwd
31 46 1365 /etc/passwd
-
-------------------------------
@@ -2371,7 +2346,7 @@ Example:
=item B<whoami>
-whoami
+whoami
Prints the user name associated with the current effective user id.
@@ -2387,7 +2362,6 @@ Example:
$ ls | xargs gzip
$ find . -name '*.c' -print | xargs rm
-
-------------------------------
@@ -2562,4 +2536,4 @@ Enrique Zanardi <ezanardi@ull.es>
=cut
-# $Id: busybox.pod,v 1.98 2001/04/09 23:27:51 kraai Exp $
+# $Id: busybox.pod,v 1.99 2001/04/10 00:00:05 kraai Exp $