Skip to content
GitLab
Menu
Projects
Groups
Snippets
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Menu
Open sidebar
cmucl
cmucl
Commits
c78ad0fa
Commit
c78ad0fa
authored
Oct 11, 2011
by
Alex Goncharov
Browse files
compiler/main.lisp: Doc strings reformat per the established conventions.
Plus one dot added. Minus the new line in ext:file-comment
parent
5079827f
Changes
1
Hide whitespace changes
Inline
Side-by-side
compiler/main.lisp
View file @
c78ad0fa
...
@@ -4,8 +4,7 @@
...
@@ -4,8 +4,7 @@
;;; This code was written as part of the CMU Common Lisp project at
;;; This code was written as part of the CMU Common Lisp project at
;;; Carnegie Mellon University, and has been placed in the public domain.
;;; Carnegie Mellon University, and has been placed in the public domain.
;;;
;;;
(
ext:file-comment
(
ext:file-comment
"$Header: src/compiler/main.lisp $"
)
"$Header: src/compiler/main.lisp $"
)
;;;
;;;
;;; **********************************************************************
;;; **********************************************************************
;;;
;;;
...
@@ -54,8 +53,8 @@
...
@@ -54,8 +53,8 @@
;;; Exported:
;;; Exported:
(
defvar
*byte-compile-top-level*
t
(
defvar
*byte-compile-top-level*
t
"Similar to *BYTE-COMPILE-DEFAULT*, but controls the compilation of top-level
"Similar to *BYTE-COMPILE-DEFAULT*, but controls the compilation of top-level
forms (evaluated at load-time) when the :BYTE-COMPILE argument is :MAYBE
forms (evaluated at load-time) when the :BYTE-COMPILE argument is :MAYBE
(the default.) When true, we decide to byte-compile."
)
(the default.) When true, we decide to byte-compile."
)
;;; Exported:
;;; Exported:
(
defvar
*loop-analyze*
nil
(
defvar
*loop-analyze*
nil
...
@@ -139,9 +138,9 @@
...
@@ -139,9 +138,9 @@
(
defvar
*user-source-info*
nil
(
defvar
*user-source-info*
nil
"The user supplied source-info for the current compilation.
"The user supplied source-info for the current compilation.
This is the :source-info argument to COMPILE-FROM-STREAM and will be
This is the :source-info argument to COMPILE-FROM-STREAM and will be
stored in the INFO slot of the DEBUG-SOURCE in code components and
stored in the INFO slot of the DEBUG-SOURCE in code components and
in the user USER-INFO slot of STREAM-SOURCE-LOCATIONs."
)
in the user USER-INFO slot of STREAM-SOURCE-LOCATIONs."
)
;;; Maybe-Mumble -- Internal
;;; Maybe-Mumble -- Internal
;;;
;;;
...
@@ -1801,56 +1800,55 @@ in the user USER-INFO slot of STREAM-SOURCE-LOCATIONs.")
...
@@ -1801,56 +1800,55 @@ in the user USER-INFO slot of STREAM-SOURCE-LOCATIONs.")
((
:xref
*record-xref-info*
)
((
:xref
*record-xref-info*
)
*record-xref-info*
))
*record-xref-info*
))
"Compiles Source, producing a corresponding .FASL file. Source may be a list
"Compiles Source, producing a corresponding .FASL file. Source may be a list
of files, in which case the files are compiled as a unit, producing a single
of files, in which case the files are compiled as a unit, producing a single
.FASL file. The output file names are defaulted from the first (or only)
.FASL file. The output file names are defaulted from the first (or only)
input file name. Other options available via keywords:
input file name. Other options available via keywords:
:Output-File
:Output-File
The name of the fasl to output, NIL for none, T for the default.
The name of the fasl to output, NIL for none, T for the default.
:Load
:Load
Load the compiled file; T here requires :Output-File to be non-NIL, as well.
Load the compiled file; T here requires :Output-File to be non-NIL, as well.
The default for :Load is NIL.
The default for :Load is NIL.
:Error-File
:Error-File
The name of the error listing file, NIL for none (the default), T for
The name of the error listing file, NIL for none (the default), T for .err.
.err.
:Trace-File
:Trace-File
If specified, internal data structures are dumped to this file. T for
If specified, internal data structures are dumped to this file. T for
the .trace default.
the .trace default.
:Error-Output
:Error-Output
If a stream, then error output is sent there as well as to the listing
If a stream, then error output is sent there as well as to the listing
file. NIL suppresses this additional error output. The default is T,
file. NIL suppresses this additional error output. The default is T,
which means use *ERROR-OUTPUT*.
which means use *ERROR-OUTPUT*.
:Block-Compile {NIL | :SPECIFIED | T}
:Block-Compile {NIL | :SPECIFIED | T}
Determines whether multiple functions are compiled together as a unit,
Determines whether multiple functions are compiled together as a unit,
resolving function references at compile time. NIL means that global
resolving function references at compile time. NIL means that global
function names are never resolved at compilation time. :SPECIFIED means
function names are never resolved at compilation time. :SPECIFIED means
that names are resolved at compile-time when convenient (as in a
that names are resolved at compile-time when convenient (as in a
self-recursive call), but the compiler doesn't combine top-level DEFUNs.
self-recursive call), but the compiler doesn't combine top-level DEFUNs.
With :SPECIFIED, an explicit START-BLOCK declaration will enable block
With :SPECIFIED, an explicit START-BLOCK declaration will enable block
compilation. A value of T indicates that all forms in the file(s) should
compilation. A value of T indicates that all forms in the file(s) should
be compiled as a unit. The default is the value of
be compiled as a unit. The default is the value of
EXT:*BLOCK-COMPILE-DEFAULT*, which is initially :SPECIFIED.
EXT:*BLOCK-COMPILE-DEFAULT*, which is initially :SPECIFIED.
:Entry-Points
:Entry-Points
This specifies a list of function names for functions in the file(s) that
This specifies a list of function names for functions in the file(s) that
must be given global definitions. This only applies to block
must be given global definitions. This only applies to block
compilation, and is useful mainly when :BLOCK-COMPILE T is specified on a
compilation, and is useful mainly when :BLOCK-COMPILE T is specified on a
file that lacks START-BLOCK declarations. If the value is NIL (the
file that lacks START-BLOCK declarations. If the value is NIL (the
default) then all functions will be globally defined.
default) then all functions will be globally defined.
:Byte-Compile {T | NIL | :MAYBE}
:Byte-Compile {T | NIL | :MAYBE}
Determines whether to compile into interpreted byte code instead of
Determines whether to compile into interpreted byte code instead of
machine instructions. Byte code is several times smaller, but much
machine instructions. Byte code is several times smaller, but much
slower. If :MAYBE, then only byte-compile when SPEED is 0 and
slower. If :MAYBE, then only byte-compile when SPEED is 0 and
DEBUG <= 1. The default is the value of EXT:*BYTE-COMPILE-DEFAULT*,
DEBUG <= 1. The default is the value of EXT:*BYTE-COMPILE-DEFAULT*,
which is initially :MAYBE.
which is initially :MAYBE.
:Xref
:Xref
If non-NIL, enable recording of cross-reference information. The default
If non-NIL, enable recording of cross-reference information. The default
is the value of C:*RECORD-XREF-INFO*
is the value of C:*RECORD-XREF-INFO*
:External-Format
:External-Format
The external format to use when opening the source file.
The external format to use when opening the source file
:Decoding-Error
:Decoding-Error
How to handle decoding errors in the external format when reading the
How to handle decoding errors in the external format when reading the
source file. Default (T) is to signal an error. Nil means silently
source file. Default (T) is to signal an error. Nil means silently
continue, replacing the invalid sequence with a suitable replacment
continue, replacing the invalid sequence with a suitable replacment
character."
character."
(
let*
((
fasl-file
nil
)
(
let*
((
fasl-file
nil
)
(
error-file-stream
nil
)
(
error-file-stream
nil
)
(
output-file-pathname
nil
)
(
output-file-pathname
nil
)
...
@@ -2129,7 +2127,7 @@ in the user USER-INFO slot of STREAM-SOURCE-LOCATIONs.")
...
@@ -2129,7 +2127,7 @@ in the user USER-INFO slot of STREAM-SOURCE-LOCATIONs.")
(
output-file
t
output-file-supplied-p
)
(
output-file
t
output-file-supplied-p
)
&allow-other-keys
)
&allow-other-keys
)
"Return a pathname describing what file COMPILE-FILE would write to given
"Return a pathname describing what file COMPILE-FILE would write to given
these arguments."
these arguments."
(
declare
(
type
(
or
string
pathname
stream
)
input-file
)
(
declare
(
type
(
or
string
pathname
stream
)
input-file
)
(
type
(
or
string
pathname
stream
(
member
t
))
output-file
)
(
type
(
or
string
pathname
stream
(
member
t
))
output-file
)
(
values
(
or
null
pathname
)))
(
values
(
or
null
pathname
)))
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment