X-Git-Url: https://feistymeow.org/gitweb/?p=feisty_meow.git;a=blobdiff_plain;f=readme.txt;h=6ea6c7b2613f6be767ce363ffd2c2f61a5551c50;hp=a9dc748594f1b0fa9e6afeb77e429135407d5e70;hb=refs%2Fheads%2Fmain;hpb=ed085f1ec9d2cd5693c6f1a990b6be04c224d1f0 diff --git a/readme.txt b/readme.txt index a9dc7485..6ea6c7b2 100644 --- a/readme.txt +++ b/readme.txt @@ -1,84 +1,93 @@ ============== + Quick Start Guide for the Feisty Meow Codebase -(Commands that you should enter into your terminal are prefixed with "=>" and -conditional portions are prefixed with a '|' character.) +Commands that can be typed in a console or terminal are prefixed with "$". +(Do not include the dollar sign when copying and pasting commands.) +Information that varies by platform is prefixed with a '|' character. + +This documentation assumes that the code is stored in the default location: + /opt/feistymeow.org/feistymeow +If you have stored it elsewhere, then please adapt the commands accordingly. ============== + How to get the feisty meow codebase +These steps assume that you have the "git" tool available. + | On Microsoft Windows, install the Cygwin tools as documented here: -| ~/feisty_meow/documentation/cygwin_install_list.txt (local file) or +| /opt/feistymeow.org/feisty_meow/documentation/cygwin_install_list.txt (local file) or | https://feistymeow.org/feisty_meow/documentation/cygwin_install_list.txt (web) -Retrieve a clone of the feisty meow code: -=> git clone git://feistymeow.org/feisty_meow - -The remainder of these notes assume that the code is stored in -~/feisty_meow (aka $HOME/feisty_meow). +Retrieve a clone of the feisty meow codebase: +$ git clone git://feistymeow.org/feisty_meow ============== -How to load the feisty meow script environment -Set up the feisty_meow scripts; this is only needed once, when you first get -the codebase. It can also regenerate the scripts using the latest version. -=> bash ~/feisty_meow/scripts/core/reconfigure_feisty_meow.sh +How to load the feisty meow script environment -Load the script environment into the current shell. -=> source ~/feisty_meow/scripts/core/launch_feisty_meow.sh +Prepare your host by installing the packages needed to bootstrap feisty meow. +If this fails, then you may need the manual installation steps at the end of +this file. +$ bash /opt/feistymeow.org/feisty_meow/scripts/core/prep_feisty_host.sh -With the feisty meow script environment loaded, several aliases are now -available for building the codebase and they are used in the sections below. +Set up the feisty_meow scripts; this is only needed once, when you first get +the codebase. +$ bash /opt/feistymeow.org/feisty_meow/scripts/core/reconfigure_feisty_meow.sh -Closing the current shell will lose the feisty meow environment. Loading the -environment can be made automatic by adding the 'source' line above to the -shell's startup file. Example startup files are available in: -~/feisty_meow/feisty_inits +Connect the feisty meow scripts to your login script (in ~/.bashrc). +Note that this actually modifies ~/.bashrc. This step is only needed once. +$ bash /opt/feistymeow.org/feisty_meow/scripts/core/connect_feisty_meow.sh -============== -How to install the feisty meow script dependencies +| For the root user, you can pass a flag '--root' to the connect_feisty_meow +| script. This will add an alias for 'feistyme' which loads the feisty meow +| scripts on demand (instead of automatically upon login). -A couple of perl modules are required by some of the scripts (including the -differ utility and the feisty meow customization system). They can be -installed with either apt-get or CPAN. +Load the script environment into the current shell. This can be done for +any new shell. This is idempotent, so it does no harm to run it again. +Note that you should not need this step if you connected feisty meow to +~/.bashrc above. +$ source /opt/feistymeow.org/feisty_meow/scripts/core/launch_feisty_meow.sh -Install using apt-get: -=> apt-get install libfile-which-perl libtext-diff-perl - -or Install using perl's CPAN: -=> cpan install Text::Diff File::Which +When the feisty meow script environment loaded, many new aliases and +functions are available for use. These come from the $FEISTY_MEOW_SCRIPTS +folder. +There is a list of feisty meow script commands available at: +https://feistymeow.org/feisty_meow/documentation/feisty_meow_command_reference.txt ============== -How to install the build dependencies for feisty meow -| Ubuntu / Debian: -| => sudo apt-get install build-essential librtmp-dev libcurl4-gnutls-dev libssl-dev +How to update the feisty meow codebase to the latest online version -| Centos / Redhat / Fedora: -| => sudo yum install gcc gcc-c++ openssl-devel.x86_64 curl-devel +This assumes that a somewhat current version of feisty meow is already +installed and the scripts are loaded (see above section for how to load). -| Microsoft Windows: -| Download and install the Cygwin environment first from cygwin.com, which is -| documented in ~/feisty_meow/documentation/cygwin_install_list.txt +The command below retrieves the latest version of feisty meow codebase +from the online repository and regenerates the scripts. + +$ rpuffer $FEISTY_MEOW_APEX ; regenerate ============== + How to build the feisty meow codebase Run the following command to build the feisty meow libraries and applications. -=> bash ~/feisty_meow/scripts/generator/produce_feisty_meow.sh +$ produce_feisty_meow After the build is complete, the feisty meow applications can be found in -$FEISTY_MEOW_BINARIES (environment variable). -=> ls $FEISTY_MEOW_BINARIES +the folder pointed at by the $FEISTY_MEOW_BINARIES environment variable. ============== + How to clean up the files generated by the build This command cleans out all the generated files: -=> bash ~/feisty_meow/scripts/generator/whack_build.sh clean +$ whack_build clean ============== + What are the feisty meow dependencies? The feisty meow scripts depend on these scripting languages and tools: @@ -93,6 +102,64 @@ The feisty meow libraries and applications depend on these tools: Curl Open SSL +The feisty meow "kona" library depends on these languages: + Java + +============== + +Bug reporting + +Report bugs at the feisty meow trac site: +https://trac.feistymeow.org/projects/feistymeow/report +Email fred@gruntose.com for authorization to write up new bug reports. + +There is also a github mirror of feisty meow at: +https://github.com/fredhamster/feisty_meow +The github repository will accept bug reports without an authorization process. + +============== + +More information is available at the official site: https://feistymeow.org + ============== -More information is available at the official site http://feistymeow.org + +Manual Installation Steps: + +How to install the feisty meow script dependencies... + +A couple of perl modules are required by some of the scripts (including the +differ utility and the feisty meow customization system). They can be +installed with either apt or CPAN. + +Install using apt (on Ubuntu or Debian-based OS): +$ sudo apt install libfile-which-perl libtext-diff-perl + +Install using yum (on Centos or similar distros): +$ sudo yum install perl-File-Which perl-Text-Diff + +or Install using perl's CPAN: +$ sudo cpan install Text::Diff File::Which + +or on Cygwin (MS-Windows), install with apt-cyg: +$ apt-cyg install perl-File-Which perl-Text-Diff + +How to install the build dependencies for feisty meow... + +These dependencies are used for building the applications, tools and tests +in the "nucleus", "octopi", "graphiq" and other C++ collections. + +| Ubuntu / Debian: +| $ sudo apt install build-essential librtmp-dev libcurl4-gnutls-dev libssl-dev + +| Centos / Redhat / Fedora: +| $ sudo yum install gcc gcc-c++ openssl-devel.x86_64 curl-devel + +The "kona" collection depends on Java version 8 or better. + +| Ubuntu: +| Set up the java PPA archive as described here: +| https://launchpad.net/~webupd8team/+archive/ubuntu/java + +============== +