mirror of
				https://gitlab.com/freepascal.org/fpc/source.git
				synced 2025-11-04 15:39:24 +01:00 
			
		
		
		
	+ Remarks from translator
This commit is contained in:
		
							parent
							
								
									e59ff956d9
								
							
						
					
					
						commit
						9024a302b9
					
				@ -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}
 | 
				
			||||||
 | 
				
			|||||||
@ -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
 | 
				
			||||||
 | 
				
			|||||||
@ -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
 | 
				
			||||||
 | 
				
			|||||||
@ -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\_work@geocities.com), for which my thanks.
 | 
					(tom\_at\_work@geocities.com), 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
 | 
					This chapter is divided in four sections. The first two sections are an
 | 
				
			||||||
introduction to the GO32 unit. The second section lists the pre-defined
 | 
					introduction to the GO32 unit. The third section lists the pre-defined
 | 
				
			||||||
constants, types and variables. The third section describes the functions
 | 
					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
 | 
					external devices like the keyboard or mouse. Functions that handle hardware
 | 
				
			||||||
handlers.
 | 
					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
 | 
					successful operation. This handle can then be used to free the memory block
 | 
				
			||||||
afterwards or use this handle for other purposes. So this block can't be
 | 
					afterwards or use this handle for other purposes. Since the function isn't
 | 
				
			||||||
deallocated and is henceforth unusuable !
 | 
					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.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
				
			|||||||
@ -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]
 | 
				
			||||||
 | 
				
			|||||||
		Loading…
	
		Reference in New Issue
	
	Block a user