Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
en:develop:guidelines [2023/09/26 13:20] – prokushev | en:develop:guidelines [2023/11/07 05:52] (current) – prokushev | ||
---|---|---|---|
Line 27: | Line 27: | ||
< | < | ||
- | + | git clone https:// | |
- | | + | git submodule update --init --recursive |
- | + | git submodule update --remote --recursive | |
- | | + | |
- | + | ||
- | | + | |
</ | </ | ||
Line 49: | Line 45: | ||
For more information about build system read [[en: | For more information about build system read [[en: | ||
- | |||
- | ==== The Directory Tree ==== | ||
- | |||
- | Please look at the source code tree to understand how files are to be placed. Please understand that the osFree source tree contains the code for an operating system and some toolkit tools. Please, DO NOT place unrelated tools or applications in this tree. The Toolkit is a set of helper utilities, which are built for development system (under which the OS is built). They are necessary for OS files building. | ||
- | |||
- | ==== Global/ | ||
- | |||
- | Each level of the source tree contains two standard directories: | ||
- | |||
- | |// | ||
- | |// | ||
- | |||
- | Each levels/part of the OS should have a specific prefix that allows a developer to easily find what part of the OS a header/ | ||
- | |||
- | <code c># | ||
- | |||
- | and code shared by all commandline tools should include: | ||
- | |||
- | <code c># | ||
- | |||
- | Try to create as few shared code headers as possible. Each “shared” directory should contain one (1) library (.lib) file (xxx_shared.lib) with all shared code and each “include” directory should contain one main header file including all other (xxx_shared.h). | ||
- | |||
- | Example of use of common files: | ||
- | |||
- | <code c> | ||
- | // Use the normal OS/2 INCL_ since our toolkit is the OS/2 toolkit | ||
- | #define INCL_DOSERROR | ||
- | |||
- | // Include os2.h | ||
- | #include < | ||
- | |||
- | // Include any needed normal C library | ||
- | #include < | ||
- | #include < | ||
- | |||
- | // Include all shared code and shared code for command line tools | ||
- | #include < | ||
- | #include < | ||
- | </ | ||
==== Documentation ==== | ==== Documentation ==== |