Index
$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · V · W · X · Y · Z
S
saidUpdatingCSSFile, NaturalDocs::Builder::HTMLBase
my $saidUpdatingCSSFile
Whether the status message “Updating CSS file...”
sub Save
Saves the class hierarchy to disk.
sub Save
Writes the changes to the menu files.
sub Save
Saves the project file to disk.
sub Save
Saves all settings in configuration files to disk.
sub Save
Saves the symbol table to disk.
SaveMenuFile, NaturalDocs::Menu
sub SaveMenuFile
Saves the current menu to Menu.txt.
SavePreviousMenuStateFile, NaturalDocs::Menu
sub SavePreviousMenuStateFile
Saves changes to PreviousMenuState.nd.
SavePreviousSettings, NaturalDocs::Settings
sub SavePreviousSettings
Saves the settings into PreviousSettings.nd.
SaveSettingsFile, NaturalDocs::Settings
sub SaveSettingsFile
Saves Settings.txt to disk.
Surrounds STable, since some browsers can’t do table padding right.
For class summaries.
For class list summaries.
scope, NaturalDocs::Parser::Native
my $scope
The scope at the current point in the file.
sub Scope
Returns what the scope was changed to.
sub Scope
Returns the scope the topic appears in.
The new scope.
The scope the topic’s body appears in.
Scope Functions, NaturalDocs::Languages::Advanced
These functions provide a nice scope stack implementation for language-specific parsers to use.
SCOPE_RECORD, NaturalDocs::Languages::Advanced
An arrayref of NaturalDocs::Languages::Advanced::ScopeChange objects, as generated by the scope stack.
SCOPE_STACK, NaturalDocs::Languages::Advanced
An arrayref of NaturalDocs::Languages::Advanced::Scope objects serving as a scope stack for parsing.
ScopeRecord, NaturalDocs::Languages::Advanced
sub ScopeRecord
Returns an arrayref of NaturalDocs::Languages::Advanced::ScopeChange objects describing how and when the scope changed thoughout the file.
ScopeSymbol, NaturalDocs::Languages::Advanced
sub ScopeSymbol
Returns the symbol that ends the current scope level, or undef if we are at the top level.
The description (right) side of the table.
A class applied to one description cell to specify the column width.
Section Functions, NaturalDocs::Builder::HTMLBase
The entry (left) side of the table.
A class applied to one entry cell to specify the column width.
SeparateMember, NaturalDocs::Languages
sub SeparateMember #(string)
Separates a class from its member.
SetBody, NaturalDocs::Parser::ParsedTopic
sub SetBody #(body)
Replaces the topic’s body, formatted in NDMarkup.
SetClass, NaturalDocs::Parser::ParsedTopic
sub SetClass #(class)
Replaces the topic’s class.
SetCurrentInterpretation, NaturalDocs::SymbolTable::Reference
sub SetCurrentInterpretation #(symbolString)
Changes the current interpretation.
sub SetDefaultMenuTitle #(file,
menuTitle)
Sets the file’s default menu title.
sub SetDefaultMenuTitle #(menuTitle)
Sets the file’s default title on the menu.
SetFlags, NaturalDocs::Menu::Entry
sub SetFlags #(flags)
Replaces the Menu Entry Flags.
sub SetHasContent #(file,
hasContent)
Sets whether the file has Natural Docs content or not.
sub SetHasContent #(hasContent)
Sets whether the file contains Natural Docs content or not.
SetLastModified, NaturalDocs::Project::File
sub SetLastModified #(lastModified)
Sets the file’s last modification timestamp.
SetName, NaturalDocs::Settings::BuildTarget
sub SetName #(name)
Changes the target’s name.
sub SetNamespace #(namespace,
lineNumber)
Sets the namespace for the current scope level.
sub SetNamespace #(namespace)
Sets the namespace of the scope.
sub SetPackage #(package,
lineNumber)
Sets the package or class for the current scope level.
sub SetPackage #(package)
Sets the package or class of the scope.
sub SetProtection #(protection,
lineNumber)
Sets the protection for the current scope level.
sub SetProtection #(protection)
Sets the protection of the scope.
sub SetPrototype #(prototype)
Replaces the function or variable prototype.
sub SetPrototype #(prototype)
Changes the prototype.
sub SetScope #(scope)
Replaces what the scope was changed to.
sub SetScope #(scope)
Replaces the topic’s scope.
SetStatus, NaturalDocs::Project::File
sub SetStatus #(status)
Sets the file’s status since the last build.
SetSummary, NaturalDocs::SymbolTable::SymbolDefinition
sub SetSummary #(summary)
Changes the summary.
SetTarget, NaturalDocs::Menu::Entry
sub SetTarget #(target)
Replaces the entry’s target.
The file that stores the Natural Docs build targets.
SettingsFile, NaturalDocs::Project
sub SettingsFile
Returns the full path to the project’s settings file.
SETTINGSFILEHANDLE, NaturalDocs::Settings
The file handle used with Settings.txt.
SetTitle, NaturalDocs::Menu::Entry
sub SetTitle #(title)
Replaces the entry’s title.
SetTokens, NaturalDocs::Languages::Advanced
sub SetTokens #(tokens)
Replaces the tokens.
SetType, NaturalDocs::SymbolTable::SymbolDefinition
sub SetType #(type)
Changes the type.
For file summaries.
For file list summaries.
For function summaries.
For function list summaries.
For generic summaries.
For generic list summaries.
For group summaries.
SharedDirectoriesOf, NaturalDocs::Menu
Returns an array of all the directories shared by the files in the group.
SHEBANG_STRINGS, NaturalDocs::Languages::Simple
An arrayref of the all-lowercase strings that can appear in the language’s shebang lines.
shebangs, NaturalDocs::Languages
my %shebangs
A hash of all the defined languages’ strings to search for in the shebang (#!)
sub ShebangStrings
Returns all the possible strings that can appear in a shebang line (#!)
sub ShebangStrings
Returns an arrayref of the strings that can appear in the language’s shebang string.
sub ShebangStrings
Returns all the possible strings that can appear in a shebang line (#!)
sub ShortenToMatchStrings #(sharedArrayRef,
compareArrayRef)
Compares two arrayrefs and shortens the first array to only contain shared entries.
Surrounding entries and descriptions that are part of a class.
Surrounding entries and descriptions that are part of a group.
Surrounds entries and descriptions that are part of a section.
SkipRestOfLine, NaturalDocs::Languages::Advanced
sub SkipRestOfLine #(indexRef,
lineNumberRef)
Moves the position to the token following the next line break, or past the end of the tokens array if there is none.
SkipRestOfStatement, NaturalDocs::Languages::Perl
sub SkipRestOfStatement #(indexRef,
lineNumberRef)
Advances the position via GenericSkip() until after the end of the current statement, which is defined as a semicolon or a brace group.
SkipUntilAfter, NaturalDocs::Languages::Advanced
sub SkipUntilAfter #(indexRef,
lineNumberRef,
token,
token,
token ...)
Moves the position to the token following the next occurance of a particular token sequence, or past the end of the tokens array if it never occurs.
The main summary.
A class applied to rows that should have a slightly different color than the rest of the rows to make them easier to read.
Sort, NaturalDocs::SymbolTable::IndexElement
sub Sort
Sorts the class and file lists of the symbol.
sourceFile, NaturalDocs::Parser
my $sourceFile
The name of the source file currently being parsed.
SOURCEFILEHANDLE, NaturalDocs::Languages::Base
The handle of the source file currently being parsed.
SplitDirectories, NaturalDocs::File
sub SplitDirectories #(directoryString)
Takes a string of directories and returns an array of its elements.
SplitFromInputDirectory, NaturalDocs::Settings
sub SplitFromInputDirectory #(file)
Takes an input file name and returns the array ( inputDirectory, relativePath ).
SplitPath, NaturalDocs::File
sub SplitPath #(path,
noFile)
Takes a path and returns its elements.
For section summaries.
The actual summary table.
Start, NaturalDocs::Parser::Native
sub Start
This will be called whenever a file is about to be parsed.
StartingParseOf, NaturalDocs::ConfigFile
sub StartingParseOf #(file)
Notifies the package that a new configuration file is about to be parsed.
StartScope, NaturalDocs::Languages::Advanced
sub StartScope #(symbol,
lineNumber,
namespace,
package,
protection)
Records a new scope level.
Statement Parsing Functions, NaturalDocs::Languages::Perl
All functions here assume that the current position is at the beginning of a statement.
Status, NaturalDocs::Project::File
sub Status
Returns the status of the file since the last build.
STATUS, NaturalDocs::Project::File
Status since the last build.
StatusOf, NaturalDocs::Project
sub StatusOf #(file)
Returns the status of the passed file.
Contains the summary title, which is the part that actually says “Summary”.
String Format, NaturalDocs::Version
String versions are normally in the common major.minor format, with the exception of “1”.
sub StringCompare #(a,
b)
Compares two strings so that the result is good for proper sorting.
StringToHTML, NaturalDocs::Builder::HTMLBase
Converts a text string to HTML.
StripClosingSymbol, NaturalDocs::Languages::Base
sub StripClosingSymbol #(lineRef,
symbols)
Determines if the line contains a symbol, and if so, truncates it just before the symbol.
StripOpeningSymbol, NaturalDocs::Languages::Base
sub StripOpeningSymbol #(lineRef,
symbols)
Determines if the line starts with any of the passed symbols, and if so, replaces it with spaces.
Style, NaturalDocs::Settings::BuildTarget
sub Style
Returns the target’s style, CSS if it’s HTML based.
STYLE, NaturalDocs::Settings::BuildTarget
The style of the target.
StyleDirectory, NaturalDocs::Settings
sub StyleDirectory
Returns the main style directory.
subTitle, NaturalDocs::Menu
my $subTitle
The sub-title of the menu.
SubTitle, NaturalDocs::Menu
sub SubTitle
Returns the sub-title of the menu, or undef if none.
The topmost style containing the entire summary.
sub Summary
Returns the topic summary, if it exists, formatted in NDMarkup.
sub Summary
Returns the summary of the class/symbol/file, if applicable.
sub Summary
Returns the target’s summary, or undef if not defined or not applicable.
sub Summary
Returns the definition’s summary, or undef if it doesn’t have one.
The summary, if it exists.
The class/symbol/file summary, or undef if not applicable.
The target’s summary, or undef if none.
The symbol’s summary, if applicable.
Everything is enclosed in a single Summary.
SummaryDefinedIn, NaturalDocs::SymbolTable::Symbol
sub SummaryDefinedIn #(file)
Returns the summary of symbol defined in the passed file, or undef if it doesn’t exist or is not defined in that file.
General functions that are used throughout the program, and that don’t really fit anywhere else.
Adding additional languages is very easy, so don’t worry if yours isn’t here.
supportedFiles, NaturalDocs::Project
my %supportedFiles
A hash of all the supported files in the input directory.
For item summaries.
For variable list summaries.
sub Symbol
Returns the closing symbol of the scope.
sub Symbol
Returns the symbol name if applicable.
sub Symbol
Returns the target’s symbol.
The closing symbol of the scope.
The name of the symbol.
The target symbol.
symbols, NaturalDocs::SymbolTable
my %symbols
A hash of all symbols, both those that are defined and those which are simply potential interpretations of references.
Symbols, NaturalDocs::SymbolTable::File
sub Symbols
Returns an array of all the symbols defined in this file.
SYMBOLS, NaturalDocs::SymbolTable::File
An existence hashref of all the symbols it defines.
The storage file for the symbol table.
SymbolTableFile, NaturalDocs::Project
sub SymbolTableFile
Returns the full path to the symbol table’s data file.
SymbolToHTMLSymbol, NaturalDocs::Builder::HTMLBase
Converts a class and symbol to a HTML symbol, meaning one that is safe to include in anchor and link tags.