浏览代码

+ Remarks from translator

michael 25 年之前
父节点
当前提交
9024a302b9
共有 5 个文件被更改,包括 23 次插入15 次删除
  1. 1 2
      docs/dos.tex
  2. 2 0
      docs/fpc.sty
  3. 6 0
      docs/getopts.tex
  4. 13 12
      docs/go32.tex
  5. 1 1
      docs/messages.tex

+ 1 - 2
docs/dos.tex

@@ -539,7 +539,6 @@ following constants :
 \item \var{VolumeId  = 08h}
 \item \var{VolumeId  = 08h}
 \item \var{Directory = 10h}
 \item \var{Directory = 10h}
 \item \var{Archive   = 20h}
 \item \var{Archive   = 20h}
-\item \var{AnyFile   = 3fh}
 \end{itemize}
 \end{itemize}
 Under \linux, supported attributes are:
 Under \linux, supported attributes are:
 \begin{itemize}
 \begin{itemize}
@@ -630,7 +629,7 @@ Procedure Intr (IntNo: byte; var Regs: registers);
 returned, the processor registers are saved in \var{Regs}.
 returned, the processor registers are saved in \var{Regs}.
 \Errors
 \Errors
 Under \linux this call does nothing, because interrupts are managed by the
 Under \linux this call does nothing, because interrupts are managed by the
-kernel. The only allowed interrupt is 80h, the kernel entry interrupt.
+kernel. The only allowed interrupt is 80h, the Linux kernel entry interrupt.
 \SeeAlso
 \SeeAlso
 \seep{MSDos}, see the \linux unit.
 \seep{MSDos}, see the \linux unit.
 \end{procedure}
 \end{procedure}

+ 2 - 0
docs/fpc.sty

@@ -213,6 +213,8 @@
 %
 %
 \ifpdf
 \ifpdf
 \usepackage[pdftex,bookmarks=true]{hyperref}
 \usepackage[pdftex,bookmarks=true]{hyperref}
+\usepackage{times}
+\usepackage[T1]{fontenc}
 \pdfcompresslevel=9
 \pdfcompresslevel=9
 \pdfpagewidth=210mm
 \pdfpagewidth=210mm
 \pdfpageheight=297mm
 \pdfpageheight=297mm

+ 6 - 0
docs/getopts.tex

@@ -21,6 +21,12 @@
 \chapter{The GETOPTS unit.}
 \chapter{The GETOPTS unit.}
 This document describes the GETOPTS unit for Free Pascal. It was written for
 This document describes the GETOPTS unit for Free Pascal. It was written for
 \linux\ by Micha\"el Van Canneyt. It also works under DOS and Tp7.
 \linux\ by Micha\"el Van Canneyt. It also works under DOS and Tp7.
+
+The getopts unit provides a mechanism to handle command-line options in
+a structured way, much like the GNU getopts mechanism. It allows you to
+define the valid options for you program, and the unit will then parse the
+command-line options for you, and inform you of any errors.
+
 The chapter is divided in 2 sections:
 The chapter is divided in 2 sections:
 \begin{itemize}
 \begin{itemize}
 \item The first section lists types, constants and variables from the
 \item The first section lists types, constants and variables from the

+ 13 - 12
docs/go32.tex

@@ -3,14 +3,14 @@ This chapter of the documentation describe the GO32 unit for the Free Pascal
 compiler under \dos. It was donated by Thomas Schatzl
 compiler under \dos. It was donated by Thomas Schatzl
 (tom\_at\[email protected]), for which my thanks.
 (tom\_at\[email protected]), for which my thanks.
 This unit was first written for \dos by Florian Klaempfl.
 This unit was first written for \dos by Florian Klaempfl.
-This chapter is divided in three sections. The first section is an
-introduction to the GO32 unit. The second section lists the pre-defined
-constants, types and variables. The third section describes the functions
+This chapter is divided in four sections. The first two sections are an
+introduction to the GO32 unit. The third section lists the pre-defined
+constants, types and variables. The last section describes the functions
 which appear in the interface part of the GO32 unit.
 which appear in the interface part of the GO32 unit.
 \section{Introduction}
 \section{Introduction}
 These docs contain information about the GO32 unit. Only the GO32V2 DPMI
 These docs contain information about the GO32 unit. Only the GO32V2 DPMI
 mode is discussed by me here due to the fact that new applications shouldn't
 mode is discussed by me here due to the fact that new applications shouldn't
-be created with the older GO32V1 model. The former is much more advanced and
+be created with the older GO32V1 model. The go32v2 version is much more advanced and
 better. Additionally a lot of functions only work in DPMI mode anyway.
 better. Additionally a lot of functions only work in DPMI mode anyway.
 I hope the following explanations and introductions aren't too confusing at
 I hope the following explanations and introductions aren't too confusing at
 all. If you notice an error or bug send it to the FPC mailing list or
 all. If you notice an error or bug send it to the FPC mailing list or
@@ -103,8 +103,8 @@ Interrupts are program interruption requests, which in one or another way
 get to the processor; there's a distinction between software and hardware
 get to the processor; there's a distinction between software and hardware
 interrupts. The former are explicitely called by an 'int' instruction and
 interrupts. The former are explicitely called by an 'int' instruction and
 are a bit comparable to normal functions. Hardware interrupts come from
 are a bit comparable to normal functions. Hardware interrupts come from
-external devices like the keyboard or mouse. These functions are called
-handlers.
+external devices like the keyboard or mouse. Functions that handle hardware
+interrupts are called handlers.
 \subsection{Handling interrupts with DPMI}
 \subsection{Handling interrupts with DPMI}
 The interrupt functions are real-mode procedures; they normally can't be
 The interrupt functions are real-mode procedures; they normally can't be
 called in protected mode without the risk of an protection fault. So the
 called in protected mode without the risk of an protection fault. So the
@@ -210,7 +210,7 @@ interrupt, a \dos memory block or any other convenient mechanism.
 When the real mode program calls the callback (via a far call), the DPMI
 When the real mode program calls the callback (via a far call), the DPMI
 host saves the registers contents in the supplied register data structure,
 host saves the registers contents in the supplied register data structure,
 switches into protected mode, and enters the callback routine with the
 switches into protected mode, and enters the callback routine with the
-following conditions:
+following settings:
 \begin{itemize}
 \begin{itemize}
 \item interrupts disabled
 \item interrupts disabled
 \item \var{\%CS:\%EIP} = 48 bit pointer specified in the original call to 
 \item \var{\%CS:\%EIP} = 48 bit pointer specified in the original call to 
@@ -403,9 +403,10 @@ Returned values: blockhandle - the memory handle to this memory block. Linear
 address of the requested memory.
 address of the requested memory.
 Notes: WARNING: According to my DPMI docs this function is not implemented
 Notes: WARNING: According to my DPMI docs this function is not implemented
 correctly. Normally you should also get a blockhandle to this block after
 correctly. Normally you should also get a blockhandle to this block after
-successful operation. This handle is used to free the memory block
-afterwards or use this handle for other purposes. So this block can't be
-deallocated and is henceforth unusuable !
+successful operation. This handle can then be used to free the memory block
+afterwards or use this handle for other purposes. Since the function isn't
+implemented correctly, and doesn't return a blockhandle, the block can't be
+deallocated and is hence unusuable !
 This function doesn't allocate any descriptors for this block, it's the
 This function doesn't allocate any descriptors for this block, it's the
 applications resposibility to allocate and initialize for accessing this
 applications resposibility to allocate and initialize for accessing this
 memory.
 memory.
@@ -467,7 +468,7 @@ Creates a new descriptor that has the same base and limit as the specified
 descriptor.
 descriptor.
 Parameters: 
 Parameters: 
 \begin{description}
 \begin{description}
-\item[seg:\ ] selector.
+\item[seg:\ ] Descriptor.
 \end{description}
 \end{description}
 Return values: The data selector (alias).
 Return values: The data selector (alias).
 Notes: In effect, the function returns a copy of the descriptor. The
 Notes: In effect, the function returns a copy of the descriptor. The
@@ -954,7 +955,7 @@ Function get\_segment\_base\_address
 specified segment.
 specified segment.
 Parameters: 
 Parameters: 
 \begin{description}
 \begin{description}
-\item[d:\ ] selector of the descriptor you want the base address.
+\item[d:\ ] selector of the descriptor you want the base address of.
 \end{description}
 \end{description}
 Return values: Linear base address of specified descriptor.
 Return values: Linear base address of specified descriptor.
 
 

+ 1 - 1
docs/messages.tex

@@ -76,7 +76,7 @@
  When the \var{-vw} switch is used, then the compiler warns you if
  When the \var{-vw} switch is used, then the compiler warns you if
  it finds nested comments. Nested comments are not allowed in Turbo Pascal
  it finds nested comments. Nested comments are not allowed in Turbo Pascal
  and can be a possible source of errors.
  and can be a possible source of errors.
-\item [Note: argF directive (FAR) ignored]
+\item [Note: directive (FAR) ignored]
  The \var{FAR} directive is a 16-bit construction which is recorgnised
  The \var{FAR} directive is a 16-bit construction which is recorgnised
  but ignored by the compiler, since it produces 32 bit code.
  but ignored by the compiler, since it produces 32 bit code.
 \item [Note: Stack check is global under Linux]
 \item [Note: Stack check is global under Linux]