From 38d7ffca0b591694c17509d20c8bf55606e60536 Mon Sep 17 00:00:00 2001
From: Trygve Laugstøl <trygvis@inamo.no>
Date: Sun, 27 Oct 2013 15:07:31 +0100
Subject: app-ls-apps: o New command to list all applications installed under a
 directory.

app-foreach-app:
o New command to execute another command for each app installed under
  the current directory.

app-init/app-install-file:
o Adding -C and -c to prepand and append config files around the
  appliation's build-in configuration files.

app-cat-conf:
o Use $APP_HOME as the 'appliation installation directory' if set.

app-operator-pid:
o Support PID files created by the launcher.
---
 docs/app.txt | 61 +++++++++++++++++++++++++++++++++++++++++++++++-------------
 1 file changed, 48 insertions(+), 13 deletions(-)

(limited to 'docs/app.txt')

diff --git a/docs/app.txt b/docs/app.txt
index c578c5d..9ab0ba7 100644
--- a/docs/app.txt
+++ b/docs/app.txt
@@ -10,28 +10,37 @@ SYNOPSIS
 [verse]
 'app' <options>
 
+DOCUMENTATION
+-------------
+
 QUICK START
 ~~~~~~~~~~~
 
-    $ app init -d my-app maven org.example:my-app:1.0-SNAPSHOT
-    $ cd my-app
-    $ app start
-    $ app conf set app.version 1.0
-    $ app upgrade
-    $ app restart
+------------------------------------------------------------------------
+$ app init -d my-app maven org.example:my-app:1.0-SNAPSHOT
+$ cd my-app
+$ app start
+$ app conf set app.version 1.0
+$ app upgrade
+$ app restart
+------------------------------------------------------------------------
 
 INSTALLING AN APPLICATION
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This resolved and downloads an appliaction from a Maven repository:
 
-    $ app init -d my-app maven org.example:my-app:1.0-SNAPSHOT
+------------------------------------------------------------------------
+$ app init -d my-app maven org.example:my-app:1.0-SNAPSHOT
+------------------------------------------------------------------------
 
 By default it will download from the central repository, but this is
 not always what you want. To get it to use another repository give the
 `-r` option:
 
-    $ app init -d my-app maven -f http://repo.example.org/snapshots org.example:my-app:1.0-SNAPSHOT
+------------------------------------------------------------------------
+$ app init -d my-app maven -f http://repo.example.org/snapshots org.example:my-app:1.0-SNAPSHOT
+------------------------------------------------------------------------
 
 UPGRADING AN APPLICATION
 ~~~~~~~~~~~~~~~~~~~~~~~~
@@ -40,7 +49,9 @@ If your application is configured with the Maven resolver and the
 version is a SNAPSHOT version, you can use this to upgrade your
 application through a cron job:
 
-    $ app upgrade
+------------------------------------------------------------------------
+$ app upgrade
+------------------------------------------------------------------------
 
 With the resolver will try to resolve `app.version` to the latest
 version. If it's change it will automatically download and install the
@@ -49,12 +60,34 @@ latest version.
 CHANGING VERSION OF AN APPLICATION
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    $ app conf set app.version 1.0
-    $ app sync-version
+------------------------------------------------------------------------
+$ app conf set app.version 1.0
+$ app sync-version
+------------------------------------------------------------------------
 
 `app-sync-version` will first run the resolver to resolve the version
 and if that has changed, it will download and install the new version.
 
+CREATING APPS
+-------------
+
+TODO
+
+CREATING HOOKS
+~~~~~~~~~~~~~~
+
+TODO
+
+CREATING LAUNCHERS
+~~~~~~~~~~~~~~~~~~
+
+Trick when you don't know why your app won't start:
+
+------------------------------------------------------------------------
+exec 1>/tmp/myapp.out
+exec 2>/tmp/myapp.err
+------------------------------------------------------------------------
+
 TODOs
 -----
 
@@ -68,8 +101,10 @@ TODOs
 SEE ALSO
 --------
 
-linkman:app-conf[1],
 linkman:app-cat-conf[1],
-linkman:appinternals[1],
+linkman:app-conf[1],
+linkman:app-install-file[1],
+linkman:app-operator-pid[1],
+linkman:appinternals[1]
 
 // vim: set ft=asciidoc:
-- 
cgit v1.2.3