more spellchecking

Author: Vladimir Kotal

Makefile

@@ -67,7 +67,6 @@ spellcheck:
 		@for file in ${SLIDES}; do \
 			echo "### Checking $$file"; \
 			$(M4) $$file | \
-			    sed 's/NOSPELLCHECK\(.*\)//' | \
 			    sed '/\begin{verbatim}/,/\end{verbatim}/d' | \
 			    sed '/\begin{alltt}/,/\end{alltt}/d' | \
 			    sed 's/pdfbookmark\[[0-9]\]{\([^{}]*\)}{.*}/pdfbookmark{\1}/' | \

file-api.tex

@@ -110,7 +110,7 @@
 current mask that can be changed via a shell command \texttt{umask} -- those
 bits in \emph{mode}, also set in the process umask, are nullified.  The
 default umask value is typically (and historically) \texttt{022}.  We recommend
-you to always se it to \texttt{077} in your profile script.  Never do that for
+you to always set it to \texttt{077} in your profile script.  Never do that for
 root though otherwise you will end up with a system in a non-supported
 configuration -- installed software will not be possible to run by
 non-privileged users, what worked before may stop working, etc.
@@ -192,16 +192,20 @@
 \begin{slide}
 \sltitle{Reading and writing files: \texttt{read()}, \texttt{write()}}
 
+ifdef([[[NOSPELLCHECK]]], [[[
 \texttt{ssize\_t \funnm{read}(int \emph{fd}, void *\emph{buf},
 size\_t \emph{nbyte});}
+]]])
 \begin{itemize}
 \item attempts to read \emph{nbyte} bytes of data from the object referenced by
 the descriptor \emph{fd} into the buffer pointed to by \emph{buf}
 \item returns the number of bytes actually read, 0 on EOF, -1 on error
 \end{itemize}
 
+ifdef([[[NOSPELLCHECK]]], [[[
 \texttt{ssize\_t \funnm{write}(int \emph{fd}, const void *\emph{buf},
 size\_t \emph{nbyte});}
+]]])
 \begin{itemize}
 \item attempts to write \emph{nbyte} of data to the object referenced by the
 descriptor \emph{fd} from the buffer pointed to by \emph{buf}
@@ -462,7 +466,7 @@
 \texttt{off\_t \funnm{lseek}(int \emph{fildes}, off\_t \emph{offset},
 int \emph{whence});}
 \begin{itemize}
-\item will reposition the file offset for reading and writing in an already
+\item will set the file offset for reading and writing in an already
 opened file associated with a file descriptor \emph{fildes}
 \item based on value of \texttt{whence}, the file offset is set to:
     \begin{itemize}
@@ -811,7 +815,10 @@
 
 \begin{slide}
 \sltitle{Setting file times}
-\texttt{int \funnm{utime}(const char *\emph{path}, const struct utimbuf *\emph{times});}
+ifdef([[[NOSPELLCHECK]]], [[[
+\texttt{int \funnm{utime}(const char *\emph{path},
+const struct utimbuf *\emph{times});}
+]]])
 \begin{itemize}
 \item changes file last access and modification times
 \item cannot change i-node access time (ctime)
@@ -865,8 +872,8 @@
 \item \texttt{unlink} does not work on directories.
 \item The shell command \texttt{mv} uses \texttt{rename} to move objects within
 the same filesystems.  To move files between filesystems, a file needs to be
-copied first, then unlinked from the originating filesystem (the whole operation
-is not atomic).
+copied first, then \texttt{unlink} it from the originating filesystem (the whole
+operation is not atomic).
 \item \texttt{rename} renames symlinks, not the files those symlinks point to.
 \item There is also a more generic call \texttt{remove}, see page
 \pageref{REMOVE}.
@@ -884,10 +891,13 @@
 \item make a new symbolic name from \emph{path2} $\rightarrow$ \emph{path1}.
 \item \emph{path1} may span filesystems, and may not exist at all
 \end{itemize}
-\texttt{int \funnm{readlink}(const char *\emph{path}, char *\emph{buf}, size\_t \emph{bufsz});} 
+ifdef([[[NOSPELLCHECK]]], [[[
+\texttt{int \funnm{readlink}(const char *\emph{path}, char *\emph{buf},
+size\_t \emph{bufsz});} 
+]]])
 \begin{itemize}
-\item put maximum of \texttt{\emph{bufsz}} bytes from the symlink target path to
-\texttt{\emph{buf}}
+\item put maximum of \emph{\texttt{bufsz}} bytes from the symlink target path
+to \texttt{\emph{buf}}
 \item returns the number of bytes written to \texttt{\emph{buf}}.
 \item \texttt{\emph{buf}} is \emsl{not} terminated by \verb#'\0'#
 \end{itemize}
@@ -896,13 +906,13 @@
 \begin{itemize}
 \item The shell command \texttt{ln} uses either the \texttt{symlink} or
 \texttt{link} syscall depending on whether the \texttt{-s} option was used.
-\item Unlinking a hardlink will not release the file data if other hardlinks
-exists.  You can delete the symlink's target in which case you end up with a
-\emph{broken link}.
+\item Calling \texttt{unlink} on a hardlink will not release the file data if
+other hardlinks exists. You can delete the symlink's target in which case you
+end up with a \emph{broken link}.
 \item \texttt{readlink} is useful in situation when you want to unlink the
 symlink's target.
-\item \texttt{\emph{bufsize}} is typically set as 1 byte less than the buffer
-size to accommodate the terminating NUL character.
+\item \emph{\texttt{bufsize}} is typically set as 1 byte less than the buffer
+size to accommodate the terminating \texttt{NULL} character.
 \end{itemize}
 
 %%%%%
@@ -920,15 +930,17 @@
 \begin{itemize}
 \item deletes directory \emph{path}.  The directory \emsl{must} be empty.
 \end{itemize}
+ifdef([[[NOSPELLCHECK]]], [[[
 \texttt{DIR *\funnm{opendir}(const char *\emph{dirname});}\\
 \texttt{struct dirent *\funnm{readdir}(DIR *\emph{dirp});}\\
 \texttt{int \funnm{closedir}(DIR *\emph{dirp});}
+]]])
 \begin{itemize}
 \item sequentially reads directory entries
 \item structure \texttt{dirent} contains:
     \begin{itemize}
-    \item \verb#d_ino# \dots{} i-node number
-    \item \verb#d_name# \dots{} file name
+    \item \texttt{d\_ino} \dots{} i-node number
+    \item \texttt{d\_name} \dots{} file name
     \end{itemize}
 \end{itemize}
 \end{slide}
@@ -1039,10 +1051,12 @@
 
 \begin{slide}
 \sltitle{Check permissions for access: \texttt{access()}}
+ifdef([[[NOSPELLCHECK]]], [[[
 \texttt{int \funnm{access}(const char *\emph{path}, int \emph{amode});}
+]]])
 \begin{itemize}
 \item checks whether the calling process can access the file \emph{path}
-\item \texttt{\emph{amode}} is an OR-combination of constants
+\item \emph{\texttt{amode}} is an OR-combination of constants
     \begin{itemize}
     \item \verb#R_OK# \dots{} read permission test
     \item \verb#W_OK# \dots{} write permission test

history.tex

@@ -169,8 +169,9 @@
 etc., e.g. UNIX V3 != SVR3.
 \item UNIX System III is therefore not UNIX V3; in those days (late 70's) there
 were multiple groups in BTL that contributed to the UNIX development.
-The ``Vx'' versions were developed in \emph{Computer Research Group}, other
-groups were \emph{Unix System Group} (USG), \emph{Programmer's WorkBench} (PWB).
+The ifdef([[[NOSPELLCHECK]]], [[[``Vx'']]]) versions were developed in
+\emph{Computer Research Group}, other groups were \emph{Unix System Group}
+(USG), \emph{Programmer's WorkBench} (PWB).
 Another branch of UNIX was Columbus UNIX also in BT. The System III version is
 based on these early versions.
 \item UNIX has forked into two main branches: AT\&T and BSD, individual

unix_dict.txt

@@ -725,3 +725,4 @@ incrementing
 decrementing
 endianess
 Downey
+unbuffered