Removed DevDoc parts, renamed file

Author: rafalsytek

doc/Document-generation.md doc/Code-Documentation.md

@@ -1,77 +1,3 @@
-## Overview
-
-`DevDoc` is written in Perl and allows to document q scripts using simple tags; produced
-documentation is in HTML format.
-
-## Installation
-
-In order to use `DevDocs`, following packages need to be installed:
-
-### `NaturalDocs`
-
-Complete package is available for download from (NaturalDocs website)[http://www.naturaldocs.org/download.html] (version
-1.52).
-
-Few small modifications are required:
-- in file `NaturalDocs.bat` please change one line from:
-
-    ```
-    perl NaturalDocs %NaturalDocsParams% 
-    ```
-
-    to:
-
-    ```
-    perl pathToNaturalDocs\NaturalDocs %NaturalDocsParams%
-    ```
-
-    For example, for NaturalDocs located in: `C:\NaturalDocs.1.52`, changed path should read:
-
-    ```
-    perl C:\NaturalDocs.1.52\NaturalDocs %NaturalDocsParams%
-    ```
-- in file: `NaturalDocs.1.52\Modules\NaturalDocs\Menu.pm` change following lines from: 
-
-    ```perl
-    use constant MAXFILESINGROUP => 6;
-    use constant MINFILESINNEWGROUP => 3;
-    ```
-
-    to:
-    
-    ```perl
-    use constant MAXFILESINGROUP => 1;
-    use constant MINFILESINNEWGROUP => 1;
-    ```
-    
-    (as per: http://sourceforge.net/projects/naturaldocs/forums/forum/279267/topic/2496639)
-    
-### Perl
-
-Recommended Perl distribution (ActivePerl) can be downloaded from: http://www.activestate.com/activeperl/downloads. Once it’s installed, please ensure that following packages are installed:
-
-- File-Next
-- File-Path
-- Log-Log4perl
-
-by searching through Perl Package Manager.
-
-### `DevDocs`
-
-`DevDocs` configuration requires to update the path in the `devDoc.pl` file, which by default is set to:
-
-```perl
-# root path to natural docs
-my $naturalDocsPath = "NaturalDocs";
-```
-
-For example, for `NaturalDocs` located in: `C:\NaturalDocs.1.52`, changed path should read:
-
-```perl
-# root path to natural docs
-my $naturalDocsPath = "C:/NaturalDocs-1.52"
-```
-
 ## Documenting your q code
 
 ### Available tags
@@ -285,62 +211,3 @@ Shows sample call related to function definition. Each tag will be shown in html
 .ns.doNothing{[a;b;c]
   };
 ```
-
-## Running `DevDocs`
-
-### General command format
-
-General command to generate documentation looks as follows:
-
-```
-perl devDoc.pl -in inputPath -out outputPath -a 1 -p 0
-```
-
-where:
-
-- `in` - input path to folder containing files for processing (mandatory parameter)
-- `out` - path to output folder storing temporary files used by `NaturalDocs` and output HTML files containing the actual documentation (mandatory parameter)
-- `a` - flag to indicate if tag `/A/` (authors) should be included (1) or omitted (0) (optional parameter)
-- `p` - flag to indicate if private variables and functions should be included (1) or omitted (0); it assumes that privates are denoted by `p` in the name, eg. `.namespace.p.varOrFuncName` (optional parameter, default is set to 0 therefore in most cases `p` parameter can be omitted)
-
-### Sample commands
-
-#### Documentation without privates
-
-```
-> perl devDoc.pl -in c:\Projects\q\qsl\trunk -out c:\Projects\q\qsl\trunk\docs
-```
-
-Alternatively, flag 0 can be used to achieve the same effect:
-
-```
-> perl devDoc.pl -in c:\Projects\q\qsl\trunk -out c:\Projects\q\qsl\trunk\docs -p 0
-```
-
-Sample log information should include similar details:
-
-```
-> perl devDoc.pl -in c:\Projects\q\qsl\trunk -out c:\Projects\q\qsl\trunk\docs
-2011/11/18 15:43:44 inPath         = c:\Projects\q\qsl\trunk
-2011/11/18 15:43:44 outPath        = c:\Projects\q\qsl\trunk\docs
-2011/11/18 15:43:44 handlePrivates = 0
-2011/11/18 15:43:44 Found file: c:/Projects/q/qsl/trunk/sl.q
-2011/11/18 15:43:44 1 q files found
-2011/11/18 15:43:44 creating file from input: c:/Projects/q/qsl/trunk/sl.q
-2011/11/18 15:43:44 saving to: c:/Projects/q/qsl/trunk/docs
-2011/11/18 15:43:44 starting NaturalDocs
-Finding files and detecting changes...
-Parsing 4 files...
-Building 1 file...
-Building 4 indexes...
-Done.
-2011/11/18 15:43:45 NaturalDocs processing completed
-```
-
-#### Documentation with privates and authors
-
-```
-> perl devDoc.pl -in c:\Projects\q\qsl\trunk -out c:\Projects\q\qsl\trunk\docs -a 1 -p 1
-```
-
-