瀏覽代碼

+ Many fixed

michael 21 年之前
父節點
當前提交
a3e93b75ee
共有 1 個文件被更改,包括 41 次插入64 次删除
  1. 41 64
      docs/oldlinux.xml

+ 41 - 64
docs/oldlinux.xml

@@ -321,18 +321,6 @@ state at the moment a signal is sent to your program.
 <element name="TDir">
 <short>Record used in <link id="OpenDir"/> and <link id="ReadDir"/> calls </short>
 </element>
-<code>
-  TDir =record
-    fd     : integer;
-    loc    : longint;
-    size   : integer;
-    buf    : pdirent;
-    nextoff: longint;
-    dd_max : integer; 
-    lock   : pointer;
-  end;
-  PDir =^TDir;
-</code>
 <element name="TDir.fd">
 <short>File descriptor. Do not use.</short>
 </element>
@@ -343,7 +331,7 @@ state at the moment a signal is sent to your program.
 <short>File size</short>
 </element>
 <element name="TDir.buf">
-<short>Pointer to <link id="TDirent"/> records</short>
+<short>Pointer to <link id="TDir"/> records</short>
 </element>
 <element name="TDir.nextoff">
 <short>?</short>
@@ -538,44 +526,44 @@ the system unit for disgnostic messages.
 </element>
 
 <element name="SA_NOCLDSTOP">
-<short>Signal flags: No child stop</short>
+<short>Sigaction options: Do not receive notification when child processes stop</short>
 </element>
 <element name="SA_SHIRQ">
-<short>Signal flags: </short>
+<short>Sigaction options: ?</short>
 </element>
 <element name="SA_STACK">
-<short>Signal flags: </short>
+<short>Sigaction options: Call the signal handler on an alternate signal stack.</short>
 </element>
 <element name="SA_RESTART">
-<short>Signal flags: </short>
+<short>Sigaction options: Provide behaviour compatible with BSD signal semantics</short>
 </element>
 <element name="SA_INTERRUPT">
-<short>Signal flags: </short>
+<short>Sigaction options: ?</short>
 </element>
 <element name="SA_NOMASK">
-<short>Signal flags: </short>
+<short>Sigaction options: Do not prevent the signal from being received when it is handled.</short>
 </element>
 <element name="SA_ONESHOT">
-<short>Signal flags: </short>
+<short>Sigaction options: Restore the signal action to the default state.</short>
 </element>
 
 <element name="SIG_BLOCK">
-<short>Signal flags: </short>
+<short>Sigprocmask flags: Add signals to the set of blocked signals.</short>
 </element>
 <element name="SIG_UNBLOCK">
-<short>Signal flags: </short>
+<short>Sigprocmask flags: Remove signals from the set set of blocked signals.</short>
 </element>
 <element name="SIG_SETMASK">
-<short>Signal flags: </short>
+<short>Sigprocmask flags: Set of blocked signals is given.</short>
 </element>
 <element name="SIG_DFL">
-<short>Signal flags: Default signal</short>
+<short>Signal handler: Default signal handler</short>
 </element>
 <element name="SIG_IGN">
-<short>Signal flags: Ignore signal</short>
+<short>Signal handler: Ignore signal</short>
 </element>
 <element name="SIG_ERR">
-<short>Signal flags: error</short>
+<short>Signal handler: error</short>
 </element>
 
 <element name="SIGHUP">
@@ -1145,8 +1133,8 @@ Auxiliary functions that are useful in connection with the other functions.
 <short>Check file access</short>
 <descr>
 <p>
-Tests user's access rights on the specified file. Mode is a mask existing of
-one or more of
+<var>Access</var> tests user's access rights on the specified file. 
+<var>Mode</var> is a mask existing of one or more of the following:
 </p>
 <dl>
 <dt>R_OK</dt><dd>User has read rights.</dd>
@@ -1191,7 +1179,7 @@ dangling symbolic link.</dd>
 <short>Schedule an alarm signal to be delivered</short>
 <descr>
 <p>
-Alarm schedules an alarm signal to be delivered to your process in <var>Sec</var>
+<var>Alarm</var> schedules an alarm signal to be delivered to your process in <var>Sec</var>
 seconds. When <var>Sec</var> seconds have elapsed, Linux will send a <var>SIGALRM</var>
 signal to the current process.  If <var>Sec</var> is zero, then no new alarm will
 be set. Whatever the value of <var>Sec</var>, any previous alarm is cancelled.
@@ -1381,8 +1369,8 @@ None.
 <element name="Chown">
 <short>Change owner of file</short>
 <descr>
-<var>Chown</var> sets the User ID and Group ID of the file in <var>Path</var> to \var{NewUid,
-NewGid}.
+<var>Chown</var> sets the User ID and Group ID of the file in <var>Path</var> to
+<var>NewUid</var>, <var>NewGid</var>
 The function returns <var>True</var> if the call was succesfull, <var>False</var> if the call
 failed.
 </descr>
@@ -1400,9 +1388,6 @@ search (=execute) permission.</dd>
 <dt>sys_enoent</dt>
 <dd> A directory entry in <var>Path</var> does
 not exist or is a symbolic link pointing to a non-existent directory.</dd>
-<dt>sys_enotdir</dt>
-<dd> A directory entry in <var>OldPath</var> or <var>NewPath</var> is
-nor a directory.</dd>
 <dt>sys_enomem</dt>
 <dd> Insufficient kernel memory.</dd>
 <dt>sys_erofs</dt>
@@ -1460,9 +1445,6 @@ search (=execute) permission.</dd>
 <dt>sys_enoent</dt>
 <dd> A directory entry in <var>Path</var> does
 not exist or is a symbolic link pointing to a non-existent directory.</dd>
-<dt>sys_enotdir</dt>
-<dd> A directory entry in <var>OldPath</var> or <var>NewPath</var> is
-nor a directory.</dd>
 <dt>sys_enomem</dt>
 <dd> Insufficient kernel memory.</dd>
 <dt>sys_erofs</dt>
@@ -1619,7 +1601,7 @@ None.
 Makes <var>NewFile</var> an exact copy of <var>OldFile</var>, after having flushed the
 buffer of <var>OldFile</var> in case it is a Text file or untyped file. 
 Due to the buffering mechanism of Pascal, this has not the same functionality
-as the \seem{dup}{2} call in C. The internal Pascal buffers are not the same 
+as the dup call in C. The internal Pascal buffers are not the same 
 after this call, but when the buffers are flushed (e.g. after output), 
 the output is sent to the same file.
 Doing an lseek will, however, work as in C, i.e. doing a lseek will change 
@@ -1870,8 +1852,6 @@ A compononent of the path has no search permission.</dd>
 <example file="olinuxex/ex8"/>
 </element>
 
-
-
 <element name="Execve">
 <short>Execute process using environment</short>
 <descr>
@@ -1887,16 +1867,16 @@ On success, <var>execve</var> does not return.
 Errors are reported in <var>LinuxError</var>:
 </p>
 <dl>
-<dt>eacces</dt>
+<dt>sys_eacces</dt>
 <dd> File is not a regular file, or has no execute permission.
 A compononent of the path has no search permission.</dd>
-<dt>sys_ eperm</dt><dd> The file system is mounted \textit{noexec}.</dd>
-<dt>sys_ e2big</dt><dd> Argument list too big.</dd>
-<dt>sys_ enoexec</dt><dd> The magic number in the file is incorrect.</dd>
-<dt>sys_ enoent</dt><dd> The file does not exist.</dd>
-<dt>sys_ enomem</dt><dd> Not enough memory for kernel.</dd>
-<dt>sys_ enotdir</dt><dd> A component of the path is not a directory.</dd>
-<dt>sys_ eloop</dt><dd> The path contains a circular reference (via symlinks).</dd>
+<dt>sys_eperm</dt><dd> The file system is mounted \textit{noexec}.</dd>
+<dt>sys_e2big</dt><dd> Argument list too big.</dd>
+<dt>sys_enoexec</dt><dd> The magic number in the file is incorrect.</dd>
+<dt>sys_enoent</dt><dd> The file does not exist.</dd>
+<dt>sys_enomem</dt><dd> Not enough memory for kernel.</dd>
+<dt>sys_enotdir</dt><dd> A component of the path is not a directory.</dd>
+<dt>sys_eloop</dt><dd> The path contains a circular reference (via symlinks).</dd>
 </dl>
 </errors>
 <seealso>
@@ -2153,7 +2133,7 @@ Errors are returned in LinuxError.
 <link id="fdClose"/>
 <link id="fdRead"/>
 <link id="fdWrite"/>
-<link id="fdTruncate"/>,
+<link id="fdTruncate"/>
 <link id="fdFlush"/>
 <link id="fdSeek"/>
 </seealso>
@@ -2461,7 +2441,7 @@ obstruction. Arg is a pointer to a flock record.
 occurs.
 </dd>
 <dt>F_GetLkw</dt>
-<dd> Same as for \textbf{F_Setlk}, but wait until the lock is
+<dd> Same as for <b>F_Setlk</b>, but wait until the lock is
 released.
 </dd>
 <dt>F_SetOwn</dt>
@@ -2484,8 +2464,8 @@ held by another process.</dd>
 <element name="Fork">
 <short>Create child process</short>
 <descr>
-Fork creates a child process which is a copy of the parent process.
-Fork returns the process ID in the parent process, and zero in the child's
+<var>Fork</var> creates a child process which is a copy of the parent process.
+<var>Fork</var> returns the process ID in the parent process, and zero in the child's
 process. (you can get the parent's PID with <link id="GetPPid"/>).
 </descr>
 <errors>
@@ -2642,7 +2622,7 @@ Get the effective user ID of the currently running process.
 None.
 </errors>
 <seealso>
-<link id="GetEUid"/>
+<link id="GetUid"/>
 </seealso>
 <example file="olinuxex/ex17"/>
 </element>
@@ -2652,9 +2632,9 @@ None.
 <short>Return value of environment variable.</short>
 <descr>
 <p>
-Returns the value of the environment variable in <var>P</var>. If the variable is
-not defined, nil is returned. The value of the environment variable may be
-the empty string.
+<var>GetEnv</var> returns the value of the environment variable in <var>P</var>. 
+If the variable is not defined, nil is returned. The value of the environment 
+variable may be the empty string.
 A PChar is returned to accomodate for strings longer than 255 bytes,
 <var>TERMCAP</var> and <var>LS_COLORS</var>, for instance.
 </p>
@@ -2662,7 +2642,7 @@ A PChar is returned to accomodate for strings longer than 255 bytes,
 <errors>
 None.
 </errors>
-<example file="olinuxex/ex41"/>
+<example file="linuxex/ex41"/>
 </element>
 
 
@@ -2962,9 +2942,6 @@ For more information on this, see various manual pages under linux.
 Errors are reported in LinuxError. They are very dependent on the used
 function, that's why we don't list them here
 </errors>
-<seealso>
-\seem{ioctl}{2}
-</seealso>
 <example file="olinuxex/ex54"/>
 </element>
 
@@ -3263,7 +3240,7 @@ None
 <short>Create FIFO (named pipe) in file system</short>
 <descr>
 <var>MkFifo</var> creates named a named pipe in the filesystem, with name
-<var>PathName</var> and mode {Mode}.
+<var>PathName</var> and mode <var>Mode</var>.
 </descr>
 <errors>
 <p>
@@ -3276,7 +3253,7 @@ None
 </errors>
 <seealso>
 <link id="POpen"/>
-<link id="MkFifo"/>, \seem{mkfifo}{4}
+<link id="MkFifo"/>
 </seealso>
 </element>
 
@@ -3407,7 +3384,7 @@ and <var>LinuxError</var> is set to <var>EINVAL</var>.
 <link id="Pause"/>
 <link id="Alarm"/>
 </seealso>
-<example file="olinuxex/ex70"/>
+<example file="olinuxex/ex72"/>
 </element>
 
 
@@ -3986,7 +3963,7 @@ None
 <short>Install signal handler (deprecated)</short>
 <descr>
 <p>
-Signal installs a new signal handler for signal <var>SigNum</var>. This call has
+<var>Signal</var> installs a new signal handler for signal <var>SigNum</var>. This call has
 the same functionality as the <b>SigAction</b> call.
 The return value for Signal is the old signal handler, or nil on error.
 </p>