Public release MSCL 62.1.2

Author: Rob Fisher

BuildScripts/NaturalDocsProjects/MSCL_API_Docs_Project/Topics.txt renamed to BuildScripts/NaturalDocsProjects/MSCL_API_Docs_Project/Comments.txt

@@ -1,4 +1,4 @@
-Format: 2.0 (Development Release 05-04-2015)
+Format: 2.0.2
 
 # This is the Natural Docs languages file for this project.  If you change
 # anything here, it will apply to THIS PROJECT ONLY.  You can edit the version
@@ -54,8 +54,8 @@
 #
 # Aliases: [alias] [alias] ...
 # [Add/Replace] Aliases: [alias] [alias] ...
-#    Defines alternate names for the language that can be used in code block
-#    tags like (start c++ code).
+#    Defines alternate names for the language that can be used to start a code
+#    block.
 #
 #
 # Properties for Basic Language Support Only
@@ -89,7 +89,7 @@
 #    Defines whether the language's identifiers are case sensitive.  The
 #    default is yes.
 #
-# [Topic Type] Prototype Enders: [symbol] [symbol] ...
+# [Comment Type] Prototype Enders: [symbol] [symbol] ...
 #    When defined, Natural Docs will attempt to get a prototype from the code
-#    immediately following the topic type.  It stops when it reaches one of
+#    immediately following the comment type.  It stops when it reaches one of
 #    these symbols.  Use \n for line breaks.

BuildScripts/NaturalDocsProjects/MSCL_API_Docs_Project/Languages.txt

@@ -1,4 +1,4 @@
-Format: 2.0 (Development Release 08-22-2015)
+Format: 2.0.2
 
 # This is the file you use to provide information about your project.  It can
 # also be used to specify input and output settings so you don't have to
@@ -29,10 +29,12 @@ Timestamp: Updated mm/dd/yyyy
 # This is where you specify general information about your project.
 #
 # Style: [style]
-#    The style to apply to the generated output.
+#    The style to apply to the generated documentation.  It can be the name of
+#    a CSS file in the project configuration folder or a subfolder that
+#    contains Style.txt.  Do not include ".css" if using a CSS file.
 
 
-# Input
+# Source Code
 # ------------------------------------------------------------------------
 
 Source Folder: ..\..\..\MSCL\source\mscl
@@ -43,39 +45,40 @@ Source Folder: ..\..\..\MSCL\source\mscl
 # scanning.  If you use any of these options on the command line, this entire
 # section is ignored except for names and numbers.
 #
-# All paths are relative to the project folder, which lets this file remain
-# portable across computers and not cause problems in version control systems.
-# You can enter absolute paths and they will be converted automatically.
+# All paths are relative to the project configuration folder, which lets this
+# file remain portable across computers and not cause problems in version
+# control systems.  You can enter absolute paths and they will be converted
+# automatically.
 #
 # Source Folder: [path]
 #    Name: [name]
 #
 #    Specifies a folder which will be searched for source files.  If you have
 #    more than one, add the Name property to set how it will show up in the
 #    menu.
-#
-# Image Folder: [path]
-#    Specifies a folder which will be searched for image files.
 
 
-# Filtering
+# Source Filtering
 # ------------------------------------------------------------------------
 
-# If there are any subfolders of the input folders that you would like Natural
+# If there are any subfolders in the source code that you would like Natural
 # Docs to ignore, they can be specified here.  If you use any of these options
 # on the command line, this entire section is ignored.
 #
 # Ignore Source Folder: [path]
 #    Tells Natural Docs to skip this folder when scanning files.
 #
 # Ignore Source Folder Pattern: [pattern]
-#    Tells Natural Docs to skip all folders which match this pattern when
+#    Tells Natural Docs to skip all folder names which match this pattern when
 #    scanning files.  ? matches a single character, * matches zero or more
 #    characters.  It applies to the entire folder name, so "cli" will not
 #    match "client", although "cli*" will.
+#
+#    The data folders of common version control systems (.git, .svn, .cvs, .hg)
+#    are ignored automatically.  You do not have to specify them here.
 
 
-# Output
+# Generated Documentation
 # ------------------------------------------------------------------------
 
 HTML Output Folder: ..\..\..\Output\Documentation\MSCL_API_Docs
@@ -85,9 +88,10 @@ HTML Output Folder: ..\..\..\Output\Documentation\MSCL_API_Docs
 # to build and where it should be put.  If you use any of these options on the
 # command line, this entire section is ignored except for secondary settings.
 #
-# All paths are relative to the project folder, which lets this file remain
-# portable across computers and not cause problems in version control systems.
-# You can enter absolute paths and they will be converted automatically.
+# All paths are relative to the project configuration folder, which lets this
+# file remain portable across computers and not cause problems in version
+# control systems.  You can enter absolute paths and they will be converted
+# automatically.
 #
 # You can override any of the project information settings under each entry,
 # so if you have multiple output folders you can give them each different

BuildScripts/NaturalDocsProjects/MSCL_API_Docs_Project/Project.txt

@@ -1,4 +1,4 @@
-Format: 2.0 (Development Release 08-22-2015)
+Format: 2.0.2
 
 # This is a configuration file for a Natural Docs HTML output style.
 
@@ -13,11 +13,10 @@ Inherit: Default
 #
 # Inherit: [style]
 #
-# All of its settings will be applied before yours.  You can inherit more than
-# one style.
+# All of its settings will be applied before yours.  You can add this line
+# multiple times to inherit more than one style.
 #
-# If you're building your own style from scratch, do not inherit anything.  If
-# you just want to make some changes to the default style, inherit Default.
+# If you just want to make some changes to the default style, inherit Default.
 # If you're building your own page design from scratch but want to keep the
 # default JavaScript functions, inherit DefaultJS.  This will include the code
 # but not the CSS or images.
@@ -35,13 +34,15 @@ Link: msclDocsStyle.css
 # Frame Link: [file]
 # Content Link: [file]
 #
-# These files will be included the generated output via link or script tags.
-# If you do not specify a page type, it will be included in every page.
+# These files will be added to the generated output via link or script tags.
 #
-# While all files will be copied to the output folder automatically, they are
-# not linked automatically.  Since JavaScript files can be loaded dynamically
-# and CSS files can be imported from other ones, you must explicitly link the
-# ones you want here.
+# You can limit them to just to the frame page, which handles the header,
+# footer, menu, and summary, or to content pages, which is the documentation
+# in the rightmost panel.  If you do not specify a page type, they will be
+# linked to every page.
+#
+# All files will be copied to the output folder even if you don't link them,
+# but they will not be added to the pages automatically.
 
 
 # OnLoad
@@ -53,9 +54,12 @@ Link: msclDocsStyle.css
 # Frame OnLoad: [statement]
 # Content OnLoad: [statement]
 #
-# If you do not specify a page type, it will be called for every page.
+# You can limit it to just to the frame page, which handles the header,
+# footer, menu, and summary, or to content pages, which is the documentation
+# in the rightmost panel.  If you do not specify a page type, it will be added
+# to every page.
 #
-# The OnLoad statement is confined to a single line.  It's recommended that
-# you make your OnLoad code a function in a separate .js file, link that file
-# from here, and then call it from this statement rather than trying to cram
-# it on this line.
+# The OnLoad statement is limited to a single line.  If you have a lot of code
+# it's recommended that you make it a function in a separate .js file, link
+# that file, and then call the function from this statement rather than trying
+# to cram it all on this line.