More pagination cleanups using \needspace and \needlines.
[dwarf-doc.git] / dwarf5 / latexdoc / programscope.tex
index cc153e2..cff986a 100644 (file)
@@ -214,7 +214,7 @@ begin with the name of the compiler vendor or some other
 identifying character sequence that should avoid confusion
 with other producer values.
 
-
+\needlines{4}
 \item  A \livelink{chap:DWATidentifiercase}{DW\-\_AT\-\_identifier\-\_case} 
 attribute 
 \addtoindexx{identifier case attribute}
@@ -305,7 +305,7 @@ this \nolink{flag}, any one of them may contain the starting function.
 which is used
 to specify and provide a user\dash specified name for the main
 subroutine of a program. 
-\addtoindex{C} uses the name “main” to identify
+\addtoindex{C} uses the name \doublequote{main} to identify
 the main subprogram of a program. Some other languages provide
 similar or other means to identify the main subprogram of
 a program.}
@@ -337,7 +337,7 @@ belong at the place of the imported unit entry.
 
 \textit{An imported unit entry does not necessarily correspond to
 any entity or construct in the source program. It is merely
-“glue” used to relate a partial unit, or a compilation
+\doublequote{glue} used to relate a partial unit, or a compilation
 unit used as a partial unit, to a place in some other
 compilation unit.}
 
@@ -461,7 +461,7 @@ a
 The value of this attribute is a
 reference to another debugging information entry describing
 a variable with a constant value. The value of this variable
-is the actual constant value of the modules priority,
+is the actual constant value of the module\textquoteright s priority,
 represented as it would be on the target architecture.
 
 \subsection{Namespace Entries}
@@ -496,6 +496,7 @@ a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute
 need only be attached directly to the original
 \livelink{chap:DWTAGnamespace}{DW\-\_TAG\-\_namespace} entry.)
 
+\needlines{4}
 Namespace and namespace extension entries may own 
 \addtoindexx{namespace extension entry}
 other
@@ -695,7 +696,7 @@ might be the original namespace entry) and no owned entries.
 
 \textit{A \addtoindex{Fortran} use statement 
 \addtoindexx{Fortran!use statement}
-with a “rename list” may be
+with a \doublequote{rename list} may be
 represented by an imported module entry with an import
 attribute referring to the module and owned entries
 corresponding to those entities that are renamed as part of
@@ -704,13 +705,13 @@ being imported.
 
 \textit{A \addtoindex{Fortran} use statement
 \addtoindexx{Fortran!use statement}
-with neither a “rename list” nor
-an “only list” may be represented by an imported module
+with neither a \doublequote{rename list} nor
+an \doublequote{only list} may be represented by an imported module
 entry with an import attribute referring to the module and
 no owned child entries.
 }
 
-\textit{A use statement with an “only list” is represented by a
+\textit{A use statement with an \doublequote{only list} is represented by a
 series of individual imported declaration entries as described
 in Section \refersec{chap:importedorrenameddeclarationentries}.
 }
@@ -1055,7 +1056,7 @@ subroutine or entry point entry may also have
 \addtoindexx{frame base attribute}
 a
 \livelink{chap:DWATframebase}{DW\-\_AT\-\_frame\-\_base} attribute, whose value is a location
-description that computes the “frame base” for the
+description that computes the \doublequote{frame base} for the
 subroutine or entry point. If the location description is
 a simple register location description, the given register
 contains the frame base address. If the location description is
@@ -1072,16 +1073,17 @@ context is equivalent to using
 but more
 compact. However, these are not equivalent in general.}
 
+\needlines{5}
 \textit{The frame base for a procedure is typically an address fixed
 relative to the first unit of storage allocated for the
-procedures stack frame. The \livelink{chap:DWATframebase}{DW\-\_AT\-\_frame\-\_base} attribute
+procedure\textquoteright s stack frame. The \livelink{chap:DWATframebase}{DW\-\_AT\-\_frame\-\_base} attribute
 can be used in several ways:}
 \begin{enumerate}[1.]
 \item \textit{In procedures that need 
 \addtoindexx{location list}
 location lists to locate local
 variables, the \livelink{chap:DWATframebase}{DW\-\_AT\-\_frame\-\_base} can hold the needed location
-list, while all variables location descriptions can be
+list, while all variables\textquoteright\  location descriptions can be
 simpler ones involving the frame base.}
 
 \item \textit{It can be used in resolving ``up\dash level'' addressing
@@ -1119,7 +1121,7 @@ life of the procedure, and
 
 \item The computed value should be unique among instances of
 the same subroutine. (For typical \livelink{chap:DWATframebase}{DW\-\_AT\-\_frame\-\_base} use, this
-means that a recursive subroutines stack frame must have
+means that a recursive subroutine\textquoteright s stack frame must have
 non\dash zero size.)
 \end{enumerate}