nedoPC.org

Electronics hobbyists community established in 2002
Atom Feed | View unanswered posts | View active topics It is currently 28 Mar 2024 04:28



Reply to topic  [ 2 posts ] 
Solid C: readme.txt 
Author Message
Admin
User avatar

Joined: 08 Jan 2003 23:22
Posts: 22409
Location: Silicon Valley
Reply with quote
Code:
             Some features of SOLID C pakage for Estex OS
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

                            C-COMPILER

Return codes of compiler (1st and 2nd pass):

   00h  - Ok
   0FFh - errors/warnings, memory allocation or file errors


                             1st pass

1. To compile "another" sources write "-k" option.

2. In options -dNAME, -jN, -oNAME and -rP:S:H spaces are not supposed.

3. Maximum length of full path to file (disk\dir\file.ext) is 80 symbols.

4. File "file.err" is made always in the current directory of input .c file.

5. Rules for includes:

     #include <file.ext>  - search only in "INCLUDE" subdirectory of
                            compiler place.

     #include "file.ext"  - search only in current subdirectory of input
                            .c file.

   Path is not allowed in include directive!
   Name of "INCLUDE" subdirectory is reserved.


                             2nd pass

1. Source files may be larger than "firm" version allow to compile.

2. Fixed two "firm" errors:
     a) TMC-files extension now allowed
     b) hang up when compile extra large sources



                             ASSEMBLER

Note: Due to assembler AS is compatible with Microsoft's assembler M80
by assembler text format, M80 documentation may be used as documentation
for assembler AS. Assembler AS does not support some directives of M80
(in general it's listing control).

1. Maximum filename length (with disk letter and subdirectories) is
   64 symbols.

2. Pseudocommand NAME('...') may include double quotes (").

3. Name of include file may be written without extention. In this case
   extention ".asm" will be used by default. The same rule is for
   output asm-file.

4. There are three variants of undocumented registers spelling:

        HX/XH      LX/XL 
        HY/YH      LY/YL 
        HIX/IXH    LIX/IXL

5. Pseudocommand  "EQU" and "=" are the same.

6. Maximum length of global label names that are transmitted to
   object file (.rel) depends on a mode of assembler work:

        6 symbols   -  when "-t" option is used
        8 symbols   -  by default
       30 symbols   -  when "-x" option is used (extended rel-format)

   Library maker does not work with extended rel-format. So, if you need
   compile library files, option "-x" must not be used.

7. Return codes for assembler:

      00h  - Ok
      0FFh - errors/warnings, memory allocation or file errors.



                               LINKER

When you link c-program with "clib.irl" library you need to set option
"/gXMAIN". It will be take control to startup-code of c-program.
See "clib" sources for details.

1. Linker works only with names of input source files. Disk and path
   in filenames are not supported.

2. Fixed "firm" bugs:
     a) wrong work with "@list" file
     b) requests to request-files

3. EXE-header has parameters: ORG = 4100h, Stack = 0C000h.
   (ORG value may be changed by option "/r").

4. File "list" consist of the only command line with arguments.
   Different arguments may be started from new line. Empty line
   must be last line in the file. Amount of bytes in file is
   limited to 256 bytes.

5. Library search: firstly *.irl, then *.rel. Else error message
   "file *.rel not found" appears.

6. Maximum length of identifire name is 30 symbols.

7. Label ?labels is not wrote to sym-file and to screen. They
   are visible only by option /Q.

8. Linker feels increasing of 16kb limit for dll-libraries (warning
   appears).

9. Return codes for linker:

      00h  - Ok
      0FFh - memory allocation or file errors.



                            LIBRARY MAKER

1. Type of opened input file is defined by content, nt by extention.

2. When library making and library name is the same as input filename,
you need write library extention to avoid double adding of files.
Extention may be missed in rel-filenames. Filenames are separated by
spaces or commas.

3. Global symbols "*" and "?" are supported only in module extracted
mode (option "e"). In another modes real filenames must be wrote.

4. Path is supported only for library file. For rel-files path is not
supported and library path is used instead.

5. When option l(ist) is used, sizes "Code size: ..." and
"Data size: ..." are showed in decimal mode.

6. When options d(ump) and l(ist) are used, screen output may be
stop/start by any key pressing. Esc-pressing means quit mode.

7. Return codes for library maker:

      00h  - Ok
      0FFh - working errors or file errors.

_________________
:dj: https://mastodon.social/@Shaos


Last edited by Shaos on 03 Sep 2012 13:20, edited 1 time in total.



08 Oct 2004 16:40
Profile WWW
Admin
User avatar

Joined: 08 Jan 2003 23:22
Posts: 22409
Location: Silicon Valley
Reply with quote
Change "Library Maker" to "Librarian"

Code:
             Some features of SOLID C pakage for Estex OS
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

                            C-COMPILER

Return codes of compiler (1st and 2nd pass):

   00h  - Ok
   0FFh - errors/warnings, memory allocation or file errors


                             1st pass

1. To compile "another" sources write "-k" option.

2. In options -dNAME, -jN, -oNAME and -rP:S:H spaces are not supposed.

3. Maximum length of full path to file (disk\dir\file.ext) is 80 symbols.

4. File "file.err" is made always in the current directory of input .c file.

5. Rules for includes:

     #include <file.ext>  - search only in "INCLUDE" subdirectory of
                            compiler place.

     #include "file.ext"  - search only in current subdirectory of input
                            .c file.

   Path is not allowed in include directive!
   Name of "INCLUDE" subdirectory is reserved.


                             2nd pass

1. Source files may be larger than "firm" version allow to compile.

2. Fixed two "firm" errors:
     a) TMC-files extension now allowed
     b) hang up when compile extra large sources



                             ASSEMBLER

Note: Due to assembler AS is compatible with Microsoft's assembler M80
by assembler text format, M80 documentation may be used as documentation
for assembler AS. Assembler AS does not support some directives of M80
(in general it's listing control).

1. Maximum filename length (with disk letter and subdirectories) is
   64 symbols.

2. Pseudocommand NAME('...') may include double quotes (").

3. Name of include file may be written without extention. In this case
   extention ".asm" will be used by default. The same rule is for
   output asm-file.

4. There are three variants of undocumented registers spelling:

        HX/XH      LX/XL 
        HY/YH      LY/YL 
        HIX/IXH    LIX/IXL

5. Pseudocommand  "EQU" and "=" are the same.

6. Maximum length of global label names that are transmitted to
   object file (.rel) depends on a mode of assembler work:

        6 symbols   -  when "-t" option is used
        8 symbols   -  by default
       30 symbols   -  when "-x" option is used (extended rel-format)

   Librarian does not work with extended rel-format. So, if you need
   compile library files, option "-x" must not be used.

7. Return codes for assembler:

      00h  - Ok
      0FFh - errors/warnings, memory allocation or file errors.



                               LINKER

When you link c-program with "clib.irl" library you need to set option
"/gXMAIN". It will be take control to startup-code of c-program.
See "clib" sources for details.

1. Linker works only with names of input source files. Disk and path
   in filenames are not supported.

2. Fixed "firm" bugs:
     a) wrong work with "@list" file
     b) requests to request-files

3. EXE-header has parameters: ORG = 4100h, Stack = 0C000h.
   (ORG value may be changed by option "/r").

4. File "list" consist of the only command line with arguments.
   Different arguments may be started from new line. Empty line
   must be last line in the file. Amount of bytes in file is
   limited to 256 bytes.

5. Library search: firstly *.irl, then *.rel. Else error message
   "file *.rel not found" appears.

6. Maximum length of identifire name is 30 symbols.

7. Label ?labels is not wrote to sym-file and to screen. They
   are visible only by option /Q.

8. Linker feels increasing of 16kb limit for dll-libraries (warning
   appears).

9. Return codes for linker:

      00h  - Ok
      0FFh - memory allocation or file errors.



                            LIBRARIAN

1. Type of opened input file is defined by content, nt by extention.

2. When library making and library name is the same as input filename,
you need write library extention to avoid double adding of files.
Extention may be missed in rel-filenames. Filenames are separated by
spaces or commas.

3. Global symbols "*" and "?" are supported only in module extracted
mode (option "e"). In another modes real filenames must be wrote.

4. Path is supported only for library file. For rel-files path is not
supported and library path is used instead.

5. When option l(ist) is used, sizes "Code size: ..." and
"Data size: ..." are showed in decimal mode.

6. When options d(ump) and l(ist) are used, screen output may be
stop/start by any key pressing. Esc-pressing means quit mode.

7. Return codes for librarian:

      00h  - Ok
      0FFh - working errors or file errors.

_________________
:dj: https://mastodon.social/@Shaos


05 Nov 2004 19:04
Profile WWW
Display posts from previous:  Sort by  
Reply to topic   [ 2 posts ] 

Who is online

Users browsing this forum: No registered users and 2 guests


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to:  
Powered by phpBB® Forum Software © phpBB Group
Designed by ST Software.