dscip.info: Compress with gzip

1 files changed, 0 insertions, 949 deletions

diff --git a/dscip.info b/dscip.info
deleted file mode 100644
index b0b5555..0000000
--- a/dscip.info
+++ /dev/null
@@ -1,949 +0,0 @@
-This is dscip.info, produced by makeinfo version 6.8 from manual.tex.
-
-Creative Commons Legal Code
-
-CC0 1.0 Universal
-
-    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
-    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
-    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
-    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
-    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
-    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
-    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
-    HEREUNDER.
-
-Statement of Purpose
-
-The laws of most jurisdictions throughout the world automatically confer
-exclusive Copyright and Related Rights (defined below) upon the creator
-and subsequent owner(s) (each and all, an "owner") of an original work of
-authorship and/or a database (each, a "Work").
-
-Certain owners wish to permanently relinquish those rights to a Work for
-the purpose of contributing to a commons of creative, cultural and
-scientific works ("Commons") that the public can reliably and without fear
-of later claims of infringement build upon, modify, incorporate in other
-works, reuse and redistribute as freely as possible in any form whatsoever
-and for any purposes, including without limitation commercial purposes.
-These owners may contribute to the Commons to promote the ideal of a free
-culture and the further production of creative, cultural and scientific
-works, or to gain reputation or greater distribution for their Work in
-part through the use and efforts of others.
-
-For these and/or other purposes and motivations, and without any
-expectation of additional consideration or compensation, the person
-associating CC0 with a Work (the "Affirmer"), to the extent that he or she
-is an owner of Copyright and Related Rights in the Work, voluntarily
-elects to apply CC0 to the Work and publicly distribute the Work under its
-terms, with knowledge of his or her Copyright and Related Rights in the
-Work and the meaning and intended legal effect of CC0 on those rights.
-
-1. Copyright and Related Rights. A Work made available under CC0 may be
-protected by copyright and related or neighboring rights ("Copyright and
-Related Rights"). Copyright and Related Rights include, but are not
-limited to, the following:
-
-  i. the right to reproduce, adapt, distribute, perform, display,
-     communicate, and translate a Work;
- ii. moral rights retained by the original author(s) and/or performer(s);
-iii. publicity and privacy rights pertaining to a person's image or
-     likeness depicted in a Work;
- iv. rights protecting against unfair competition in regards to a Work,
-     subject to the limitations in paragraph 4(a), below;
-  v. rights protecting the extraction, dissemination, use and reuse of data
-     in a Work;
- vi. database rights (such as those arising under Directive 96/9/EC of the
-     European Parliament and of the Council of 11 March 1996 on the legal
-     protection of databases, and under any national implementation
-     thereof, including any amended or successor version of such
-     directive); and
-vii. other similar, equivalent or corresponding rights throughout the
-     world based on applicable law or treaty, and any national
-     implementations thereof.
-
-2. Waiver. To the greatest extent permitted by, but not in contravention
-of, applicable law, Affirmer hereby overtly, fully, permanently,
-irrevocably and unconditionally waives, abandons, and surrenders all of
-Affirmer's Copyright and Related Rights and associated claims and causes
-of action, whether now known or unknown (including existing as well as
-future claims and causes of action), in the Work (i) in all territories
-worldwide, (ii) for the maximum duration provided by applicable law or
-treaty (including future time extensions), (iii) in any current or future
-medium and for any number of copies, and (iv) for any purpose whatsoever,
-including without limitation commercial, advertising or promotional
-purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
-member of the public at large and to the detriment of Affirmer's heirs and
-successors, fully intending that such Waiver shall not be subject to
-revocation, rescission, cancellation, termination, or any other legal or
-equitable action to disrupt the quiet enjoyment of the Work by the public
-as contemplated by Affirmer's express Statement of Purpose.
-
-3. Public License Fallback. Should any part of the Waiver for any reason
-be judged legally invalid or ineffective under applicable law, then the
-Waiver shall be preserved to the maximum extent permitted taking into
-account Affirmer's express Statement of Purpose. In addition, to the
-extent the Waiver is so judged Affirmer hereby grants to each affected
-person a royalty-free, non transferable, non sublicensable, non exclusive,
-irrevocable and unconditional license to exercise Affirmer's Copyright and
-Related Rights in the Work (i) in all territories worldwide, (ii) for the
-maximum duration provided by applicable law or treaty (including future
-time extensions), (iii) in any current or future medium and for any number
-of copies, and (iv) for any purpose whatsoever, including without
-limitation commercial, advertising or promotional purposes (the
-"License"). The License shall be deemed effective as of the date CC0 was
-applied by Affirmer to the Work. Should any part of the License for any
-reason be judged legally invalid or ineffective under applicable law, such
-partial invalidity or ineffectiveness shall not invalidate the remainder
-of the License, and in such case Affirmer hereby affirms that he or she
-will not (i) exercise any of his or her remaining Copyright and Related
-Rights in the Work or (ii) assert any associated claims and causes of
-action with respect to the Work, in either case contrary to Affirmer's
-express Statement of Purpose.
-
-4. Limitations and Disclaimers.
-
- a. No trademark or patent rights held by Affirmer are waived, abandoned,
-    surrendered, licensed or otherwise affected by this document.
- b. Affirmer offers the Work as-is and makes no representations or
-    warranties of any kind concerning the Work, express, implied,
-    statutory or otherwise, including without limitation warranties of
-    title, merchantability, fitness for a particular purpose, non
-    infringement, or the absence of latent or other defects, accuracy, or
-    the present or absence of errors, whether or not discoverable, all to
-    the greatest extent permissible under applicable law.
- c. Affirmer disclaims responsibility for clearing rights of other persons
-    that may apply to the Work or any use thereof, including without
-    limitation any person's Copyright and Related Rights in the Work.
-    Further, Affirmer disclaims responsibility for obtaining any necessary
-    consents, permissions or other rights required for any use of the
-    Work.
- d. Affirmer understands and acknowledges that Creative Commons is not a
-    party to this document and has no duty or obligation with respect to
-    this CC0 or use of the Work.
-
-
-File: dscip.info,  Node: Top,  Next: Installing,  Up: (dir)
-
-Dead Simple Continuous Integration POSIX Manual
-***********************************************
-
-This is the manual for the Dead Simple Continuous Integration POSIX
-program.
-
-Dead Simple Continuous Integration POSIX Manual by Charadon
-(DSCIP Manual for short.)
-
-To the extent possible under law, the person who associated CC0 with
-DSCIP Manual has waived all copyright and related or neighboring rights
-to DSCIP Manual.
-
-You should have received a copy of the CC0 legalcode along with this
-work.  If not, see:
-   <https://creativecommons.org/publicdomain/zero/1.0/>.
-
-* Menu:
-
-* Installing::
-* Using::
-* Quirks::
-
-* Manual's License::
-* Index::
-
-
-File: dscip.info,  Node: Installing,  Next: Using,  Prev: Top,  Up: Top
-
-1 Installing
-************
-
-Details on installing DSCIP onto various systems.
-* Menu:
-
-* Downloading::
-* Unix::
-* Windows::
-* Packaging::
-* Using Templates::
-
-
-File: dscip.info,  Node: Downloading,  Next: Unix,  Up: Installing
-
-1.1 Downloading
-===============
-
-Currently, the upstream repo for DSCIP is located at this Git Repo
-(https://www.opencode.net/charadon/dscip).  If your OS doesn't have
-DSCIP packaged, you can download the 'setup.sh' from the releases page,
-and use that to install dscip.  Alternatively, you can clone the git
-repo into whatever directory you want.
-
-
-File: dscip.info,  Node: Unix,  Next: Windows,  Prev: Downloading,  Up: Installing
-
-1.2 Unix
-========
-
-In this section, Unix refers to systems that are similar in nature to
-the old System V Unix or is POSIX in nature.  This would include: Linux,
-BSD, Mac, Haiku, and Illumos.
-
-The instructions will pretty much be the same for all systems.
-
-* Menu:
-
-* As a Package::
-* Manually::
-
-
-File: dscip.info,  Node: As a Package,  Next: Manually,  Up: Unix
-
-1.2.1 As a Package
-------------------
-
-If your host OS packaged DSCIP correctly according to Packaging (*Note
-Packaging::), these instructions should work.
-
-  1. Run 'setup-dscip' in the terminal.  See 'setup-dscip -h' for more
-     details.
-  2. Add the new script as a cronjob or daemon.  See your OS's manual
-     for instructions on how to do so.
-
-   And that's it!  You're ready to go!
-
-
-File: dscip.info,  Node: Manually,  Prev: As a Package,  Up: Unix
-
-1.2.2 Manually
---------------
-
-While not as simple as if it was packaged.  The process is still not
-that hard.
-  1. Run 'setup.sh'.  See 'setup.sh -h' for more details.
-  2. Add the new script as a cronjob or daemon.  See your OS's manual
-     for instructions on how to do so.
-   And that's it!  You're ready to go!
-
-
-File: dscip.info,  Node: Windows,  Next: Packaging,  Prev: Unix,  Up: Installing
-
-1.3 Windows
-===========
-
-Windows is a different beast from Unix.  So it warrants it's own
-dedicated section.
-* Menu:
-
-* MSYS2 (Recommended)::
-* Only Bash::
-* Task Scheduler::
-
-
-File: dscip.info,  Node: MSYS2 (Recommended),  Next: Only Bash,  Up: Windows
-
-1.3.1 MSYS2 (Recommended)
--------------------------
-
-  1. Install MSYS2 (https://www.msys2.org) in whatever way you want.  I
-     recommend using Scoop (https://scoop.sh).
-  2. Once MSYS2 is installed, run setup.sh ('setup.sh -h' for more
-     info.).
-  3. Now we'll need a way to run it regularly.  I recommend using the
-     Task Scheduler that comes with Windows.  Here's a step-by-step
-     guide: *Note Task Scheduler::
-
-
-File: dscip.info,  Node: Only Bash,  Next: Task Scheduler,  Prev: MSYS2 (Recommended),  Up: Windows
-
-1.3.2 Bash
-----------
-
-The easiest way to get Bash on Windows is to install git, so we'll be
-assuming that path.
-  1. Install Git for Windows (https://gitforwindows.org/), I recommend
-     using Scoop (https://scoop.sh).
-  2. Once Git is installed, you should be able to run 'bash' from the
-     command prompt or powershell.  Once in Bash, run setup.sh
-     ('setup.sh -h' for more info.)  and install dscip.
-  3. Now we'll need a way to run it regularly.  I recommend using Task
-     Scheduler that comes with Windows.  Here's a step-by-step guide:
-     *Note Task Scheduler::
-
-
-File: dscip.info,  Node: Task Scheduler,  Prev: Only Bash,  Up: Windows
-
-1.3.3 Using Task Scheduler
---------------------------
-
-Once you have DSCIP installed, you'll need to have it run on a regular
-basis.  For this, Windows has the Task Scheduler.  Using it is very
-simple, and i'll go over a basic set up with it.  Also, you should
-always use an unpriviledged user.
-  1. Create a batch/powershell script that runs bash on the DSCIP
-     script.  This script should be located somewhere that the
-     unpriviledged user can run it.
-     Here is an a batch example:
-          set MSYSTEM=MINGW64 :: If you're using MSYS2
-          C:\Users\Build\scoop\apps\msys2\current\usr\bin\bash -l -c "/home/Build/project/dscip"
-  2. Log in as an Administrator user and open Task Scheduler by press
-     Win+R, and typing taskschd.msc into the Run Dialog.
-  3. Right click on 'Task Scheduler Library' and click 'Create Task'
-  4. Under Security Options, change the User to an unpriviledged user,
-     and set to 'Run whether user is logged on or not.'
-  5. Go to 'Triggers' and click the 'New...'  button.  A new window will
-     pop up with options to schedule when the task will execute.  First
-     thing you should do is click the 'Begin the Task' drop-down menu
-     and select 'At startup', this will ensure that the task will run
-     with every reboot.  As for schedule settings, I recommend going
-     down to advanced and checking the box 'Repeat task every:' and
-     putting in '1 minute' into the box, and then selecting
-     'Indenfinitely' in the 'for a duration of' box.  Now click the 'OK'
-     button to save your settings.
-  6. Go to the 'Actions' tab and click the 'New...'  button at the
-     bottom.  In the 'New Action' dialog that will pop up, select the
-     Batch/Powershell script you made earlier.  There's no need to
-     select a 'Start In' location, as the script by default tries to
-     change directory into the directory where the script is stored at.
-  7. From here, you can configure any options you want, but if you have
-     no further configuration needs, click the 'Ok' button to close out
-     of the 'Create Task' window.  Now just reboot the machine.
-And that should be it, it will now run DSCIP every minute.
-
-
-File: dscip.info,  Node: Packaging,  Next: Using Templates,  Prev: Windows,  Up: Installing
-
-1.4 Packaging
-=============
-
-Packaging is pretty easy, just run 'make install' and it'll do
-everything for you.  You can use environment variables to change where
-certain things go though.
-  1. 'PREFIX': This specifies where on the system everything will go.
-     By default it's /usr/local.
-  2. 'BINDIR': The directory to install setup.sh to.  When installed, it
-     will change it's name to 'setup-dscip'.
-  3. 'INFODIR': The directory to install the manual.  Default is
-     'PREFIX'/share/info.
-This is the general layout that the Makefile defaults to:
-     .
-     |-- bin
-     |   `-- setup-dscip (setup.sh)
-     `-- share
-         |-- charadon
-         |   `-- dscip
-         |       |-- build.sh
-         |       |-- config.sh
-         |       |-- dscip
-         |       |-- failed.sh
-         |       |-- post.sh
-         |       `-- pre.sh
-         `-- info
-             `-- dscip.info.gz
-
-
-You'll note two things:
-  1. 'update.sh' is not included.  This is mainly mean't for non-package
-     installs.  Such as direct 'git' clones, or using the 'setup.sh'
-     script on it's own.
-  2. 'SCRIPT_DIR' cannot be changed from it's default of
-     $PREFIX/share/charadon/dscip.  This is because the 'setup.sh'
-     script relies on the scripts being there to symlink to them.
-
-
-File: dscip.info,  Node: Using Templates,  Prev: Packaging,  Up: Installing
-
-1.5 Using Templates
-===================
-
-Templates are an easy way to quickly get a DSCIP instance up and
-running.  Since most developers tend to have all their projects build
-almost the exact same way, you can easily create a git repo with your
-DSCIP scripts and have the setup script copy them over.  You can point
-to the directory containing your templates by using the '-t' argument
-with setup.sh.  You find find an example of templates here at my Git
-Repo (https://www.opencode.net/charadon/my-dscip-templates-v1)
-
-
-File: dscip.info,  Node: Using,  Next: Quirks,  Prev: Installing,  Up: Top
-
-2 Using
-*******
-
-This chapter goes over how to actually use DSCIP.
-* Menu:
-
-* Scripts::
-* Basic Variables::
-* Advanced Variables::
-
-
-File: dscip.info,  Node: Scripts,  Next: Basic Variables,  Up: Using
-
-2.1 Scripts
-===========
-
-This section covers all the scripts in DSCIP, what they do, and with
-examples.
-* Menu:
-
-* config_dot_sh::
-* setup_dot_sh::
-* update_dot_sh::
-* pre_dot_sh::
-* build_dot_sh::
-* failed_dot_sh::
-* post_dot_sh::
-
-
-File: dscip.info,  Node: config_dot_sh,  Next: setup_dot_sh,  Up: Scripts
-
-2.1.1 config.sh
----------------
-
-'config.sh' is where all the variables for dscip are stored.  Any
-variable in here can be used in any other script.  See *Note Basic
-Variables::.
-Example:
-     #!/bin/sh
-     # Variables that control the program. #
-     # GIT Repo #
-     export DSCIP_GITREPO="https://www.example.com/example/example.git"
-     export DSCIP_NAME="Example"
-     # GIT MODE:                                                   #
-     # pull: Doesn't delete previous clone and just pulls changes. #
-     # clone: Deletes previous clone, and creates a fresh clone.   #
-     export DSCIP_GITMODE="clone"
-     # Branch to check #
-     export DSCIP_BRANCH="master"
-     # The directory where all the scripts are. By default tries to detect where    #
-     # automatically.                                                               #
-     WORKING_DIRECTORY="$(pwd -P)"
-     export WORKING_DIRECTORY
-     # Commands to run before building. #
-     export DSCIP_PRE_CMD="$WORKING_DIRECTORY/pre.sh"
-     # Commands to run to build program. #
-     export DSCIP_BUILD_CMD="$WORKING_DIRECTORY/build.sh"
-     # Commands to run after building has succeeded. #
-     export DSCIP_POST_CMD="$WORKING_DIRECTORY/post.sh"
-     # Commands to run after building has failed.
-     export DSCIP_FAILED_CMD="$WORKING_DIRECTORY/failed.sh"
-     # Daemon mode options #
-     export DSCIP_DAEMON="false" # If daemon mode should be enabled or not. #
-     export DSCIP_DAEMON_FORK="true" # If the daemon should run in the background. #
-     export DSCIP_SLEEP="60" # How many seconds before the daemon re-runs itself. #
-     # etc #
-     export DSCIP_DISREGARD_COMMIT_CHECK="false" # If the script should just rebuild even #
-     # if upstream has not updated. #
-     export DSCIP_OUTPUT_TO="$WORKING_DIRECTORY/output.txt" # Output to file, default is output.txt
-     # Automatically update DSCIP?
-     export DSCIP_AUTO_UPDATE="false"
-
-
-File: dscip.info,  Node: setup_dot_sh,  Next: update_dot_sh,  Prev: config_dot_sh,  Up: Scripts
-
-2.1.2 setup.sh
---------------
-
-This script will handle the downloading, installing/symlinking, and
-configuration of a DSCIP instance.  It has two modes of operation:
-  1. Interactive Mode: If no argument is supplied, it will ask the user
-     questions on how it wants to set up the dscip instance.
-  2. Non-interactive Mode: If arguments are supplied, it will use those
-     arguments to create a DSCIP instance.
-
-See 'setup.sh -h' for more info.  This script can also go by the name
-'setup-dscip' if it's packaged.
-
-Example:
-     ./setup.sh -n "Pong-C" -d /home/builder/Pong-C -u "https://opencode.net/charadon/pong-c" -b master -t /home/builder/templates
-
-
-File: dscip.info,  Node: update_dot_sh,  Next: pre_dot_sh,  Prev: setup_dot_sh,  Up: Scripts
-
-2.1.3 update.sh
----------------
-
-This script updates the 'dscip' script.  It shouldn't be present if
-packaged for a system.  It's only useful manual installations.
-
-
-File: dscip.info,  Node: pre_dot_sh,  Next: build_dot_sh,  Prev: update_dot_sh,  Up: Scripts
-
-2.1.4 pre.sh
-------------
-
-This script contains the commands to run *before* the build commands.
-This script can do things such as:
-  1. Update the System.
-  2. Grab assets from a remote URL not part of the git repo.
-  3. Probe to see if certain services are up and running.  Such as a FTP
-     server to upload artifacts to.
-
-
-If this script doesn't exit with 0, then DSCIP aborts.  Another thing to
-note, is that DSCIP will run whatever the shebang is, so this script can
-be made in other languages, such as Perl, Python, Powershell, Batch, C
-Shell, etc.
-
-Example:
-     #!/bin/sh
-     set -eu
-
-     # Execute commands before building.
-     # Below is an example.
-
-     # Build user implied to have sudo access to apt update and upgrade
-     sudo apt update -y
-     sudo apt upgrade -y
-
-     # Including assets with game code is usually a bad idea, so we grab the assets
-     # from a mirror.
-     wget https://www.example.com/project/game_assets.zip
-     unzip game_assets.zip
-
-     exit 0
-
-
-File: dscip.info,  Node: build_dot_sh,  Next: failed_dot_sh,  Prev: pre_dot_sh,  Up: Scripts
-
-2.1.5 build.sh
---------------
-
-This script contains the build commands for your project.  If the script
-doesn't return 0, it will run *Note 'failed.sh': failed_dot_sh,
-otherwise, it will run *Note 'post.sh': post_dot_sh.
-Example:
-
-     #!/bin/sh
-
-     set -eu
-
-     # Insert build commands in here. #
-     # If you're feeling particular paranoid, you can make it chroot here. #
-
-     ./configure
-     make -j4
-     make DESTDIR=app install
-
-     exit 0
-
-
-File: dscip.info,  Node: failed_dot_sh,  Next: post_dot_sh,  Prev: build_dot_sh,  Up: Scripts
-
-2.1.6 failed.sh
----------------
-
-This script tells DSCIP what to do if the build failed.  Like pre.sh, it
-must return 0 or else DSCIP will abort.
-Example:
-     #!/bin/sh
-
-     set -eu
-
-     # This script determines what to do if the build failed.
-     # Below is an example of uploading the output.txt to an ftp server.
-     ftp -in <<EOF
-     open 192.168.1.5
-     user username password
-     mkdir $DSCIP_NAME
-     cd $DSCIP_NAME
-     mkdir $CURRENT_COMMIT
-     cd $CURRENT_COMMIT
-     mkdir $(uname)
-     cd $(uname)
-     put $WORKING_DIRECTORY/output.txt output-failed.txt
-     close
-     bye
-     EOF
-
-
-File: dscip.info,  Node: post_dot_sh,  Prev: failed_dot_sh,  Up: Scripts
-
-2.1.7 post.sh
--------------
-
-This script tells DSCIP what to do if the build succeeded.  Like pre.sh,
-it must return 0 or else DSCIP will abort.
-Example:
-     #!/bin/sh
-
-     set -eu
-
-     # Execute commands after building. Like pushing to an FTP server.              #
-     # Example below. #
-
-     # TAR up the program.                                                          #
-     bsdtar -a -cf \
-     $DSCIP_NAME-$(uname)-$(uname -r)_$(uname -m)-$CURRENT_COMMIT.tar.xz app/
-
-     # Send the artifacts to an FTP server.                                         #
-     ftp -in <<EOF
-     open 192.168.255.255
-     user username pAssw0rd
-     mkdir $DSCIP_NAME
-     cd $DSCIP_NAME
-     mkdir $CURRENT_COMMIT
-     cd $CURRENT_COMMIT
-     mkdir $(uname)
-     cd $(uname)
-     put $DSCIP_NAME-$(uname)-$(uname -r)_$(uname -m)-$CURRENT_COMMIT.tar.xz
-     put $WORKING_DIRECTORY/output.txt output-success.txt
-     close
-     bye
-     EOF
-
-     exit 0
-
-
-File: dscip.info,  Node: Basic Variables,  Next: Advanced Variables,  Prev: Scripts,  Up: Using
-
-2.2 Basic Variables
-===================
-
-This section goes over variables that you can safely modify in config.sh
-and/or use in your scripts.
-
-2.2.1 DSCIP_GITREPO
--------------------
-
-This is the variable that determines what git repo DSCIP clones into
-wrkdir.  It should be noted that this isn't limited to a remote URL. It
-can also clone from a local system git repo.  This can be useful if you
-want to forbid internet access to the builder user.
-
-2.2.2 DSCIP_NAME
-----------------
-
-This variable determines the name of the program that's being build.
-Mostly for use with the 'post.sh' and 'failed.sh' scripts when
-publishing artifacts.
-
-2.2.3 DSCIP_BRANCH
-------------------
-
-This variable tells DSCIP which branch to clone.  This is useful if you
-develop in a branch other than master.
-
-2.2.4 DSCIP_DAEMON
-------------------
-
-This variable will tell DSCIP to not close, but rather stay open and
-just sleep before re-running itself.  Useful for Windows, if you want
-DSCIP to run in shorter time periods than 60 seconds, or use special
-features that your OS's init system gives.
-
-2.2.5 DSCIP_DAEMON_FORK
------------------------
-
-This variable tells DSCIP if it should run itself in the background.
-Some init systems prefer one or the other, so consult your OS's
-documentation.
-
-2.2.6 DSCIP_SLEEP
------------------
-
-When in daemon mode, this controls how long DSCIP should wait between
-attempted builds before checking for a new commit and building if one
-exists.
-
-2.2.7 DSCIP_OUTPUT_TO
----------------------
-
-This variable tells DSCIP where to put logs.  By default it puts all
-output into output.txt.  This is useful if, for example, you're running
-DSCIP in daemon mode, and need to store logs somewhere else.
-
-2.2.8 DSCIP_DATE_FORMAT
------------------------
-
-This variable tells DSCIP how it should format 'COMMIT_DATE'.  See
-'strftime(3)' for more information of time codes.
-
-2.2.9 LAST_COMMIT
------------------
-
-This variable tells DSCIP what the last commit was.  This variable
-should be treated as *readonly* and should never be modified.
-
-2.2.10 CURRENT_COMMIT
----------------------
-
-This variable tells DSCIP what commit it's currently building.  This
-variable like LAST_COMMIT should be treated as *readonly* and should
-never be modified.
-
-2.2.11 COMMIT_DATE
-------------------
-
-This variable is the date that the commit was created on.  This can be
-used in your post scripts to organize artifacts if you wish.  This
-string is formatted with 'DSCIP_DATE_FORMAT' above.
-
-
-File: dscip.info,  Node: Advanced Variables,  Prev: Basic Variables,  Up: Using
-
-2.3 Advanced Variables
-======================
-
-These are variables you should only change if you absolutely need to!
-
-2.3.1 DSCIP_GITMODE
--------------------
-
-This tells DSCIP to, rather than delete the wrkdir and get a fresh
-clone, to just pull changes.  This is really only useful in situations
-where you have limited bandwidth.
-
-2.3.2 WORKING_DIRECTORY
------------------------
-
-This should probably never be changed.  The only situation that *might*
-warrant changing it, is in a very restricted environment where it *has*
-to run in a specific place.
-
-2.3.3 DSCIP_{PRE,BUILD,POST,FAILED}_CMD
----------------------------------------
-
-These variables tell DSCIP where to find their respective scripts.  Like
-WORKING_DIRECTORY, this really shouldn't be changed and is really only
-useful in situations that are very restrictive.
-
-2.3.4 DSCIP_DISREGARD_COMMIT_CHECK
-----------------------------------
-
-This variable tells DSCIP to ignore the commit check and just keep
-rebuilding.  This is useful for seeing if old/unmaintained software will
-still build on modern systems.  But other than that, should be left off.
-
-2.3.5 DSCIP_AUTO_UPDATE
------------------------
-
-This variable tells DSCIP to run 'update.sh', and then run a checksum on
-itself.  If it's different from when it first launched, It'll re-run
-itself.  This is useful for manual installations.
-
-
-File: dscip.info,  Node: Quirks,  Next: Manual's License,  Prev: Using,  Up: Top
-
-3 Quirks
-********
-
-This chapter goes over various quirks that have been discovered with
-DSCIP. None so far...
-
-
-File: dscip.info,  Node: Manual's License,  Next: Index,  Prev: Quirks,  Up: Top
-
-4 Manual's License
-******************
-
-Creative Commons Legal Code
-
-CC0 1.0 Universal
-
-    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
-    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
-    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
-    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
-    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
-    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
-    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
-    HEREUNDER.
-
-Statement of Purpose
-
-The laws of most jurisdictions throughout the world automatically confer
-exclusive Copyright and Related Rights (defined below) upon the creator
-and subsequent owner(s) (each and all, an "owner") of an original work of
-authorship and/or a database (each, a "Work").
-
-Certain owners wish to permanently relinquish those rights to a Work for
-the purpose of contributing to a commons of creative, cultural and
-scientific works ("Commons") that the public can reliably and without fear
-of later claims of infringement build upon, modify, incorporate in other
-works, reuse and redistribute as freely as possible in any form whatsoever
-and for any purposes, including without limitation commercial purposes.
-These owners may contribute to the Commons to promote the ideal of a free
-culture and the further production of creative, cultural and scientific
-works, or to gain reputation or greater distribution for their Work in
-part through the use and efforts of others.
-
-For these and/or other purposes and motivations, and without any
-expectation of additional consideration or compensation, the person
-associating CC0 with a Work (the "Affirmer"), to the extent that he or she
-is an owner of Copyright and Related Rights in the Work, voluntarily
-elects to apply CC0 to the Work and publicly distribute the Work under its
-terms, with knowledge of his or her Copyright and Related Rights in the
-Work and the meaning and intended legal effect of CC0 on those rights.
-
-1. Copyright and Related Rights. A Work made available under CC0 may be
-protected by copyright and related or neighboring rights ("Copyright and
-Related Rights"). Copyright and Related Rights include, but are not
-limited to, the following:
-
-  i. the right to reproduce, adapt, distribute, perform, display,
-     communicate, and translate a Work;
- ii. moral rights retained by the original author(s) and/or performer(s);
-iii. publicity and privacy rights pertaining to a person's image or
-     likeness depicted in a Work;
- iv. rights protecting against unfair competition in regards to a Work,
-     subject to the limitations in paragraph 4(a), below;
-  v. rights protecting the extraction, dissemination, use and reuse of data
-     in a Work;
- vi. database rights (such as those arising under Directive 96/9/EC of the
-     European Parliament and of the Council of 11 March 1996 on the legal
-     protection of databases, and under any national implementation
-     thereof, including any amended or successor version of such
-     directive); and
-vii. other similar, equivalent or corresponding rights throughout the
-     world based on applicable law or treaty, and any national
-     implementations thereof.
-
-2. Waiver. To the greatest extent permitted by, but not in contravention
-of, applicable law, Affirmer hereby overtly, fully, permanently,
-irrevocably and unconditionally waives, abandons, and surrenders all of
-Affirmer's Copyright and Related Rights and associated claims and causes
-of action, whether now known or unknown (including existing as well as
-future claims and causes of action), in the Work (i) in all territories
-worldwide, (ii) for the maximum duration provided by applicable law or
-treaty (including future time extensions), (iii) in any current or future
-medium and for any number of copies, and (iv) for any purpose whatsoever,
-including without limitation commercial, advertising or promotional
-purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
-member of the public at large and to the detriment of Affirmer's heirs and
-successors, fully intending that such Waiver shall not be subject to
-revocation, rescission, cancellation, termination, or any other legal or
-equitable action to disrupt the quiet enjoyment of the Work by the public
-as contemplated by Affirmer's express Statement of Purpose.
-
-3. Public License Fallback. Should any part of the Waiver for any reason
-be judged legally invalid or ineffective under applicable law, then the
-Waiver shall be preserved to the maximum extent permitted taking into
-account Affirmer's express Statement of Purpose. In addition, to the
-extent the Waiver is so judged Affirmer hereby grants to each affected
-person a royalty-free, non transferable, non sublicensable, non exclusive,
-irrevocable and unconditional license to exercise Affirmer's Copyright and
-Related Rights in the Work (i) in all territories worldwide, (ii) for the
-maximum duration provided by applicable law or treaty (including future
-time extensions), (iii) in any current or future medium and for any number
-of copies, and (iv) for any purpose whatsoever, including without
-limitation commercial, advertising or promotional purposes (the
-"License"). The License shall be deemed effective as of the date CC0 was
-applied by Affirmer to the Work. Should any part of the License for any
-reason be judged legally invalid or ineffective under applicable law, such
-partial invalidity or ineffectiveness shall not invalidate the remainder
-of the License, and in such case Affirmer hereby affirms that he or she
-will not (i) exercise any of his or her remaining Copyright and Related
-Rights in the Work or (ii) assert any associated claims and causes of
-action with respect to the Work, in either case contrary to Affirmer's
-express Statement of Purpose.
-
-4. Limitations and Disclaimers.
-
- a. No trademark or patent rights held by Affirmer are waived, abandoned,
-    surrendered, licensed or otherwise affected by this document.
- b. Affirmer offers the Work as-is and makes no representations or
-    warranties of any kind concerning the Work, express, implied,
-    statutory or otherwise, including without limitation warranties of
-    title, merchantability, fitness for a particular purpose, non
-    infringement, or the absence of latent or other defects, accuracy, or
-    the present or absence of errors, whether or not discoverable, all to
-    the greatest extent permissible under applicable law.
- c. Affirmer disclaims responsibility for clearing rights of other persons
-    that may apply to the Work or any use thereof, including without
-    limitation any person's Copyright and Related Rights in the Work.
-    Further, Affirmer disclaims responsibility for obtaining any necessary
-    consents, permissions or other rights required for any use of the
-    Work.
- d. Affirmer understands and acknowledges that Creative Commons is not a
-    party to this document and has no duty or obligation with respect to
-    this CC0 or use of the Work.
-
-
-File: dscip.info,  Node: Index,  Prev: Manual's License,  Up: Top
-
-Index
-*****
-
-
-* Menu:
-
-* Advanced Variables:                    Advanced Variables.   (line  6)
-* Advanced Variables: DSCIP_AUTO_UPDATE: Advanced Variables.   (line 39)
-* Advanced Variables: DSCIP_DISREGARD_COMMIT_CHECK: Advanced Variables.
-                                                               (line 32)
-* Advanced Variables: DSCIP_GITMODE:     Advanced Variables.   (line 11)
-* Advanced Variables: DSCIP_{PRE,BUILD,POST,FAILED}_CMD: Advanced Variables.
-                                                               (line 25)
-* Advanced Variables: WORKING_DIRECTORY: Advanced Variables.   (line 18)
-* Basic Variables:                       Basic Variables.      (line  6)
-* Basic Variables: COMMIT_DATE:          Basic Variables.      (line 81)
-* Basic Variables: CURRENT_COMMIT:       Basic Variables.      (line 74)
-* Basic Variables: DSCIP_BRANCH:         Basic Variables.      (line 27)
-* Basic Variables: DSCIP_DAEMON:         Basic Variables.      (line 33)
-* Basic Variables: DSCIP_DAEMON_FORK:    Basic Variables.      (line 41)
-* Basic Variables: DSCIP_DATE_FORMAT:    Basic Variables.      (line 62)
-* Basic Variables: DSCIP_GITREPO:        Basic Variables.      (line 12)
-* Basic Variables: DSCIP_NAME:           Basic Variables.      (line 20)
-* Basic Variables: DSCIP_OUTPUT_TO:      Basic Variables.      (line 55)
-* Basic Variables: DSCIP_SLEEP:          Basic Variables.      (line 48)
-* Basic Variables: LAST_COMMIT:          Basic Variables.      (line 68)
-* Downloading:                           Downloading.          (line  6)
-* Installing:                            Installing.           (line  6)
-* Installing on Unix:                    Unix.                 (line  6)
-* Installing on Windows:                 Windows.              (line  6)
-* Manual's License:                      Manual's License.     (line  6)
-* Packaging:                             Packaging.            (line  6)
-* Quirks:                                Quirks.               (line  6)
-* Scripts: build.sh:                     build_dot_sh.         (line  6)
-* Scripts: config.sh:                    config_dot_sh.        (line  6)
-* Scripts: failed.sh:                    failed_dot_sh.        (line  6)
-* Scripts: post.sh:                      post_dot_sh.          (line  6)
-* Scripts: pre.sh:                       pre_dot_sh.           (line  6)
-* Scripts: setup.sh:                     setup_dot_sh.         (line  6)
-* Scripts: update.sh:                    update_dot_sh.        (line  6)
-* Unix: Install Manually:                Manually.             (line  6)
-* Unix: Installing Packaged DSCIP:       As a Package.         (line  6)
-* Using:                                 Using.                (line  6)
-* Using Templates:                       Using Templates.      (line  6)
-* Using: Scripts:                        Scripts.              (line  6)
-* Windows: Installing on MSYS2:          MSYS2 (Recommended).  (line  6)
-* Windows: Installing with only Bash:    Only Bash.            (line  6)
-* Windows: Using Task Scheduler:         Task Scheduler.       (line  6)
-
-
-
-Tag Table:
-Node: Top7120
-Node: Installing7829
-Node: Downloading8062
-Node: Unix8481
-Node: As a Package8864
-Node: Manually9325
-Node: Windows9712
-Node: MSYS2 (Recommended)9972
-Node: Only Bash10478
-Node: Task Scheduler11161
-Node: Packaging13407
-Node: Using Templates14786
-Node: Using15385
-Node: Scripts15595
-Node: config_dot_sh15900
-Node: setup_dot_sh17896
-Node: update_dot_sh18654
-Node: pre_dot_sh18915
-Node: build_dot_sh20004
-Node: failed_dot_sh20554
-Node: post_dot_sh21258
-Node: Basic Variables22283
-Node: Advanced Variables24863
-Node: Quirks26301
-Node: Manual's License26496
-Node: Index33668
-
-End Tag Table
-
-
-Local Variables:
-coding: utf-8
-End: