From 03b9bcfdc59f1516cb47a4c64a98ad78c4b395a8 Mon Sep 17 00:00:00 2001 From: Warren Toomey Date: Mon, 28 Mar 2016 21:56:58 +1000 Subject: [PATCH] A few more man pages converted to roff format. --- man/ls.1 | 66 +++++++++++++++++++++++++++++++++++------------------- man/od.1 | 28 +++++++++++++++++++++++ man/stat.1 | 37 ++++++++++++++++-------------- 3 files changed, 91 insertions(+), 40 deletions(-) create mode 100644 man/od.1 diff --git a/man/ls.1 b/man/ls.1 index e59325e..c2f594e 100644 --- a/man/ls.1 +++ b/man/ls.1 @@ -1,24 +1,44 @@ - 11/3/70 LS (I) +.oh '11/3/70''LS(I)' +.ta 18 21 24 +NAME ls -- list contents of directory +.sp +SYNOPSIS ls [ -l ] directory +.sp +DESCRIPTION +.ul +ls +lists the contents of the named directory + under control of one option: +.sp + l list in long format, giving i-number, + mode, owner, size in words, and name of + each file. (see +.ul +stat +for format of the + mode). Numeric values are in octal. +.sp +FILES -- +.sp +SEE ALSO stat +.sp +DIAGNOSTICS "name ?" if the named directory does not exist + or cannot be opened. +.sp +BUGS In a simulated environment, a filename larger + than eight characters will cause +.ul +ls +to exit + prematurely. +.sp + +.ul +ls +will try to open up a directory named "." if + no directory is named. If the user desires this + functionality, they need to link "." to the + directory in question. - -NAME ls -- list contents of directory - -SYNOPSIS ls [ -l ] - -DESCRIPTION ls lists the contents of the current directory under - control of one option: - - l list in long format, giving i-number, mode, owner, - size in words, and name of each file. (see stat - for format of the mode). Numeric values are in octal. - -FILES - -SEE ALSO stat - -DIAGNOSTICS No diagnostics - -BUGS In a simulated environment, a filename larger than eight - characters will cause ls to exit prematurely. - -OWNER wkt +.sp +OWNER wkt diff --git a/man/od.1 b/man/od.1 new file mode 100644 index 0000000..baf4592 --- /dev/null +++ b/man/od.1 @@ -0,0 +1,28 @@ +.oh '11/3/70''OD(I)' +.ta 18 21 +NAME od -- octal dump +.sp +SYNOPSIS +.ul +od +file +.sp +DESCRIPTION +.ul +od +dumps the words of the named file in octal + format, eight words per line. Each line is + prefixed by the offset into the file, and this + is separated from the file output by a colon. +.sp +FILES -- +.sp +SEE ALSO -- +.sp +DIAGNOSTICS If a file cannot be opened, its name is printed + followed by "?". If no argument is given, "no + arg" is output. +.sp +BUGS -- +.sp +OWNER wkt diff --git a/man/stat.1 b/man/stat.1 index fd594b4..817e11f 100644 --- a/man/stat.1 +++ b/man/stat.1 @@ -1,13 +1,16 @@ .oh '11/3/70''STAT(I)' -.ta 18 21 -NAME stat - get file status +.ta 18 21 24 +NAME stat -- get file status .sp SYNOPSIS .ul stat name .sp -DESCRIPTION stat gives several kinds of information about +DESCRIPTION +.ul +stat +gives several kinds of information about one file: .sp access mode @@ -20,25 +23,25 @@ DESCRIPTION stat gives several kinds of information about mode. The mode is a five-character string whose characters mean the following: .sp - 1 s: file is small (smaller than 4096 words) - l: file is large - d: file is a directory + 1 s: file is small (smaller than 448 words) + l: file is large + d: file is a directory .sp - 2 r: owner can read - -: owner cannot read + 2 r: owner can read + -: owner cannot read .sp - 3 w: owner can write - -: owner cannot write + 3 w: owner can write + -: owner cannot write .sp - 4 r: non-owner can read - -: non-owner cannot read + 4 r: non-owner can read + -: non-owner cannot read .sp - 5 w: non-owner can write - -: non-owner cannot write + 5 w: non-owner can write + -: non-owner cannot write .sp All numeric values are printed in octal. .sp -FILES +FILES -- .sp SEE ALSO .ul @@ -50,8 +53,8 @@ stat, except that it also shows the i-node number for each file. .sp -DIAGNOSTICS "name ?" for any error. - "nofiles" if no file name is given. +DIAGNOSTICS "name ?" for any error. "nofiles" if no file + name is given. .sp BUGS none .sp