From 522534a7bd53a59fda047e96706405b5f7622d55 Mon Sep 17 00:00:00 2001 From: Kevin Day Date: Sun, 11 Dec 2022 22:17:39 -0600 Subject: [PATCH] Update: Out of date build documentation. The "See: ..." files should now end in ".txt". The directory structure for both the status project and the work directory have changed since this documentation was last modified. Update documentation regarding running Featureless Make with no arguments. Remove redundant "Alternatively..." documentation that is already described elsewhere. --- build/documents/readme.bootstrap.txt | 47 +++++++++++++++++++++--------------- build/documents/readme.build.txt | 46 +++++++++++++++++++++++------------ build/documents/readme.txt | 4 +-- 3 files changed, 59 insertions(+), 38 deletions(-) diff --git a/build/documents/readme.bootstrap.txt b/build/documents/readme.bootstrap.txt index 9aef645..840cb8f 100644 --- a/build/documents/readme.bootstrap.txt +++ b/build/documents/readme.bootstrap.txt @@ -36,27 +36,32 @@ Bootstrap Readme Documentation: cp -vR build/programs/shared/* /usr/bin/ cp -vR build/settings/* /etc/ - Alternatively, a primitive install script is provided to help install\: - ./install.sh - If one of the build sub-directories, such as includes, libraries, programs, and settings, is empty or missing after a successful build, then there are no files of that type to install. - Build Tree Structure Example (using the status_code-0.6.2 project)\: + Build Tree Structure Example (using the FLL status_code-0.6.2 project)\: build/ ├── documents ├── includes - │   └── level_3 - │   └── status_code.h + │   └── program + │   └── status_code + │   ├── common.h + │   └── status_code.h ├── libraries │   ├── script │   ├── shared │   │   ├── libstatus_code.so -> libstatus_code.so.0 - │   │   ├── libstatus_code.so.0 -> libstatus_code.so.0.6.2 + │   │   ├── libstatus_code.so.0 -> libstatus_code.so.0.6 + │   │   ├── libstatus_code.so.0.6 -> libstatus_code.so.0.6.2 │   │   └── libstatus_code.so.0.6.2 │   └── static │   └── libstatus_code.a ├── objects + │   ├── common.o + │   ├── private-common.o │   ├── private-status_code.o + │   ├── script + │   ├── shared + │   ├── static │   └── status_code.o ├── programs │   ├── script @@ -66,26 +71,28 @@ Bootstrap Readme Documentation: │   └── status_code ├── settings └── stage - ├── libraries_shared.built - ├── libraries_static.built - ├── objects_static.built - ├── programs_shared.built - ├── programs_static.built - ├── skeleton.built - ├── sources_headers.built - ├── sources_script.built - └── sources_settings.built - + ├── library_shared-settings.built + ├── library_static-settings.built + ├── objects_static-settings.built + ├── program_shared-settings.built + ├── program_static-settings.built + ├── skeleton-settings.built + ├── sources_headers-settings.built + ├── sources_script-settings.built + └── sources_settings-settings.built Work Tree Structure Example at /tmp/work (using the status_code-0.6.2 project)\: /tmp/work/ ├── includes - │   └── level_3 - │   └── status_code.h + │   └── program + │   └── status_code + │   ├── common.h + │   └── status_code.h ├── libraries │   ├── shared │   │   ├── libstatus_code.so -> libstatus_code.so.0 - │   │   ├── libstatus_code.so.0 -> libstatus_code.so.0.6.2 + │   │   ├── libstatus_code.so.0 -> libstatus_code.so.0.6 + │   │   ├── libstatus_code.so.0.6 -> libstatus_code.so.0.6.2 │   │   └── libstatus_code.so.0.6.2 │   └── static │   └── libstatus_code.a diff --git a/build/documents/readme.build.txt b/build/documents/readme.build.txt index cdf55dd..e77f9ce 100644 --- a/build/documents/readme.build.txt +++ b/build/documents/readme.build.txt @@ -25,24 +25,35 @@ Build Readme Documentation: fake build Build Example, using "make"\: + fake + + Build Example, explicitly using "make"\: fake make Build Tree Structure Example (using the status_code-0.6.2 project)\: build/ ├── documents ├── includes - │   └── level_3 - │   └── status_code.h + │   └── program + │   └── status_code + │   ├── common.h + │   └── status_code.h ├── libraries │   ├── script │   ├── shared │   │   ├── libstatus_code.so -> libstatus_code.so.0 - │   │   ├── libstatus_code.so.0 -> libstatus_code.so.0.6.2 + │   │   ├── libstatus_code.so.0 -> libstatus_code.so.0.6 + │   │   ├── libstatus_code.so.0.6 -> libstatus_code.so.0.6.2 │   │   └── libstatus_code.so.0.6.2 │   └── static │   └── libstatus_code.a ├── objects + │   ├── common.o + │   ├── private-common.o │   ├── private-status_code.o + │   ├── script + │   ├── shared + │   ├── static │   └── status_code.o ├── programs │   ├── script @@ -52,25 +63,28 @@ Build Readme Documentation: │   └── status_code ├── settings └── stage - ├── libraries_shared.built - ├── libraries_static.built - ├── objects_static.built - ├── programs_shared.built - ├── programs_static.built - ├── skeleton.built - ├── sources_headers.built - ├── sources_script.built - └── sources_settings.built + ├── library_shared-settings.built + ├── library_static-settings.built + ├── objects_static-settings.built + ├── program_shared-settings.built + ├── program_static-settings.built + ├── skeleton-settings.built + ├── sources_headers-settings.built + ├── sources_script-settings.built + └── sources_settings-settings.built Work Tree Structure Example at '/tmp/work' (using the status_code-0.6.2 project)\: /tmp/work/ ├── includes - │   └── level_3 - │   └── status_code.h + │   └── program + │   └── status_code + │   ├── common.h + │   └── status_code.h ├── libraries │   ├── shared │   │   ├── libstatus_code.so -> libstatus_code.so.0 - │   │   ├── libstatus_code.so.0 -> libstatus_code.so.0.6.2 + │   │   ├── libstatus_code.so.0 -> libstatus_code.so.0.6 + │   │   ├── libstatus_code.so.0.6 -> libstatus_code.so.0.6.2 │   │   └── libstatus_code.so.0.6.2 │   └── static │   └── libstatus_code.a @@ -82,4 +96,4 @@ Build Readme Documentation: See: FLL Fake project documents for further details on how to use the Fake system. See: FLL Fake project specifications for how to configure the build FSS files and make FSS files. - See: readme.bootstrap for notes on installing. + See: readme.bootstrap.txt for notes on installing. diff --git a/build/documents/readme.txt b/build/documents/readme.txt index 3eb8df9..ca5ef54 100644 --- a/build/documents/readme.txt +++ b/build/documents/readme.txt @@ -49,5 +49,5 @@ Readme Documentation: Use it as an example or explicitly call it (such as: "bash build/scripts/bootstrap-example.sh monolithic 0.6.0"). See: dependencies for specific dependencies of this project. - See: readme.bootstrap for bootstrap compiling (or just regular compiling) any part of the FLL and notes on installing. - See: readme.build for Featureless Make compiling and notes on installing. + See: readme.bootstrap.txt for bootstrap compiling (or just regular compiling) any part of the FLL and notes on installing. + See: readme.build.txt for Featureless Make compiling and notes on installing. -- 1.8.3.1