add lexical binding cookie to lisp/helper.el (#623)

CMUCL was published as .tar.bz2 up to 21e and switched to .tar.xz with
21f, but the installer always asked for .tar.bz2.  Since it picks the
newest release when no version is given, `ros install cmu-bin` now
always 404s:

  Downloading https://common-lisp.net/project/cmucl/downloads/release/21f/cmucl-21f-x86-linux.tar.bz2
  Downloading archive:...:NG
  bzip2: Can't open input file .../cmucl-21f-x86-linux.tar.bz2
  tar: This does not look like a tar archive
  Error: unable to use 'cmu-bin'

Look the file up in the release directory instead of assuming, the same
listing cmu-bin-get-version already parses, and keep .tar.bz2 as the
fallback when the listing can't be read.  extract() already handles .xz,
so nothing else needs to change.

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>

.github/workflows/docker-build.yml

@@ -0,0 +1,27 @@
+name: docker-build
+
+on:
+  workflow_dispatch:
+
+env:
+  DOCKER_BUILDKIT: 1
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    environment: DOCKER_IMAGE
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Login GitHub Registry
+        run: echo ${{ secrets.GITHUB_TOKEN }} | docker login docker.pkg.github.com -u snmsts --password-stdin
+      - name: Build image
+        env:
+          IMAGE: ${{ secrets.IMAGE }}
+        run: |
+          echo building $(cat ./scripts/Docker/$IMAGE/Name) ...
+          docker build -t docker.pkg.github.com/${{ github.repository }}/$(cat ./scripts/Docker/$IMAGE/Name) ./scripts/Docker/$IMAGE
+      - name: Push image to GitHub Registry
+        env:
+          IMAGE: ${{ secrets.IMAGE }}
+        run: docker push docker.pkg.github.com/${{ github.repository }}/$(cat ./scripts/Docker/$IMAGE/Name)

.github/workflows/linux.yml

@@ -0,0 +1,93 @@
+name: Linux
+
+on:
+  push:
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        image: [musl64]
+        variant: ['', '-musl', '-glibc2.31']
+        target: ['x86_64', 'arm64', 'riscv64']
+        include:
+          # set default docker platform and image suffix.
+          - {docker-platform: linux/amd64  ,docker-image-suffix: '', makeopts: musl }
+          - {target: arm64   ,docker-platform: linux/arm64   ,docker-image-suffix: 'aarch64' }
+          - {target: riscv64 ,docker-platform: linux/riscv64 ,docker-image-suffix: 'riscv64' }
+          - {image: deb,    makeopts: deb,  target: x86-64 ,docker-platform: linux/amd64}
+          - {image: pandoc, makeopts: docs, target: x86-64 ,docker-platform: linux/amd64}
+
+    environment: SET_VERSION
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+        with:
+          image: tonistiigi/binfmt:qemu-v8.1.5
+      - name: setenv
+        run: |
+          echo "$HOME/.roswell/bin" >> $GITHUB_PATH
+          echo "ROSWELL_BRANCH=release" >> $GITHUB_ENV
+      - name: checkenv
+        run: |
+          uname -s -m
+      - name: Install Roswell
+        env:
+          LISP: sbcl-bin/2.4.0
+          GITHUB_OAUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          IMAGE: ${{ matrix.image }}
+        run: |
+          sh scripts/install-for-ci.sh
+          ros install snmsts/sn.github
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: docker.pkg.github.com
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: pull or build&push docker image
+        env:
+          DOCKER_PLATFORM: ${{ matrix.docker-platform }}
+          DOCKER_BUILD_OPTIONS: ${{ matrix.docker-build-options }}
+          DOCKER_IMAGE_SUFFIX: ${{ matrix.docker-image-suffix }}
+          IMAGE: ${{ matrix.image }}
+        run: |
+          if [ -n "$IMAGE" ]; then
+             make -f scripts/Makefile pull-docker || make -f scripts/Makefile build-docker push-docker
+          fi
+      - name: build
+        env:
+          VERSION: ${{ secrets.VERSION }}
+          ARCH: ${{ matrix.target }}
+          DOCKER: ${{ matrix.docker }}
+          SUFFIX: ${{ matrix.suffix }}
+          LINKFLAGS: ${{ matrix.linkflags }}
+          DOCKER_PLATFORM: ${{ matrix.docker-platform }}
+          DOCKER_BUILD_OPTIONS: ${{ matrix.docker-build-options }}
+          DOCKER_IMAGE_SUFFIX: ${{ matrix.docker-image-suffix }}
+          IMAGE: ${{ matrix.image }}
+          MAKEOPTS: ${{ matrix.makeopts }}
+          VARIANT: ${{ matrix.variant }}
+        run: |
+          if [ "$VERSION" = "" ]; then
+            make -f scripts/Makefile latest-version docker
+          else
+            make -f scripts/Makefile docker
+          fi
+      - name: upload
+        env:
+          GITHUB_OAUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VERSION: ${{ secrets.VERSION }}
+          ARCH: ${{ matrix.target }}
+          SUFFIX: ${{ matrix.suffix }}
+        run: |
+          if [ "$VERSION" = "" ]; then
+            make -f scripts/Makefile latest-version ${{ matrix.makeopts }}-upload
+          else
+            make -f scripts/Makefile ${{ matrix.makeopts }}-upload
+          fi

.github/workflows/osx.yml

@@ -0,0 +1,45 @@
+name: osx
+
+on:
+  push:
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ${{ matrix.target == 'arm64' && 'macos-14' || 'macos-15-intel' }}
+    strategy:
+      fail-fast: false
+      matrix:
+        lisp: [sbcl-bin/2.3.8]
+        target: [arm64, x86-64]
+    environment: SET_VERSION
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: setenv
+        run: |
+          echo "$HOME/.roswell/bin" >> $GITHUB_PATH
+          echo "ROSWELL_INSTALL_DIR=$HOME/.roswell" >> $GITHUB_ENV
+      - name: checkenv
+        run: |
+          uname -s -m
+          brew install autoconf automake
+      - name: Build
+        env:
+          CFLAGS: -mmacosx-version-min=10.9
+          CXXFLAGS: -mmacosx-version-min=10.9
+          LDFLAGS: -mmacosx-version-min=10.9
+          ARCH: ${{ matrix.target }}
+        run: |
+          gcc -v
+          ./bootstrap
+          ./configure --prefix=$ROSWELL_INSTALL_DIR
+          make
+          make install
+          make pack
+          ros install snmsts/sn.github
+      - name: Upload
+        env:
+          GITHUB_OAUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          make -f scripts/Makefile latest-version musl-upload

.github/workflows/test.yml

@@ -0,0 +1,75 @@
+name: test
+
+on:
+  schedule:
+    - cron:  '0 1 * * *'
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    continue-on-error: ${{ matrix.experimental }}
+    timeout-minutes: 90
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [macos-latest, ubuntu-latest]
+        lisp: 
+         - alisp
+         - cmu-bin/2019-06
+         - sbcl
+         - ecl
+         - clisp
+         - ccl-bin
+         - sbcl/2.4.0
+         - ccl32
+        experimental: [false]
+        exclude:
+          - lisp: ccl-bin
+            os: macos-latest
+          - lisp: ccl32
+            os: macos-latest
+          - lisp: cmu-bin/2019-06
+            os: macos-latest
+        include:
+          - lisp: mkcl
+            os: macos-latest
+            experimental: true
+          - lisp: mkcl
+            os: ubuntu-latest
+            experimental: true
+          - lisp: sbcl/git
+            os: macos-latest
+            experimental: true
+          - lisp: sbcl/git
+            os: ubuntu-latest
+            experimental: true
+          - lisp: abcl
+            os: macos-latest
+            experimental: true
+          - lisp: abcl
+            os: ubuntu-latest
+            experimental: true
+
+    env:
+      LISP: ${{ matrix.lisp }}
+      ROSWELL_REPO: https://github.com/${{ github.repository }}
+      ROSWELL_BRANCH: ${{ github.head_ref }}
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: setenv
+        run: |
+          echo "$HOME/.roswell/bin" >> $GITHUB_PATH
+          echo "ROSWELL_INSTALL_DIR=$HOME/.roswell" >> $GITHUB_ENV
+      - name: Install Roswell
+        run: |
+          sh ./scripts/install-for-ci.sh
+      - name: script
+        run: |
+          ros version
+          ros version=t run
+          ros install prove
+          run-prove roswell-test.asd 2>&1
+          ros -q run && [ "$(ros -q run 2>&1)" = "" ]
+          ros config

.github/workflows/windows.yml

@@ -0,0 +1,113 @@
+name: windows
+
+on:
+  push:
+  workflow_dispatch:
+
+jobs:
+  build-windows:
+    runs-on: windows-latest
+    timeout-minutes: 90
+    strategy:
+      fail-fast: false
+      matrix:
+        arch: [x86_64, i686]
+        include:
+        - arch: x86_64
+          arch2: amd64
+          bit: 64
+        - arch: i686
+          arch2: i686
+          bit: 32
+    env:
+      RESULT_NAME: windows-${{ matrix.arch2 }}
+      RESULT_PATH: windows-${{ matrix.arch2 }}
+      RESULT_PATH_SUB: roswell
+
+    environment: SET_VERSION
+
+    steps:
+      - run: git config --global core.autocrlf false
+      - uses: actions/checkout@v2
+      - uses: msys2/setup-msys2@v2
+        with:
+          msystem: MINGW${{ matrix.bit }}
+          path-type: inherit
+          release: true
+          update: true
+          install: >-
+            base-devel
+            p7zip
+            autotools
+            mingw-w64-${{ matrix.arch }}-toolchain
+            mingw-w64-${{ matrix.arch }}-autotools
+      - name: Run MSYS2 once
+        shell: msys2 {0}
+        run: |
+          pwd
+          echo $MSYSTEM
+          echo $MSYS2_PATH_TYPE
+          echo $PATH
+      - name: Build
+        shell: msys2 {0}
+        run: |
+          gcc -v
+          ./bootstrap
+          ./configure
+          make
+          make install
+          make pack.zip
+      - name: Upload
+        env:
+          GITHUB_OAUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        shell: msys2 {0}
+        run: |
+          make -f scripts/Makefile latest-version win-upload
+
+  build-windows-arm64:
+    runs-on: windows-11-arm
+    timeout-minutes: 90
+    env:
+      RESULT_NAME: windows-aarch64
+      RESULT_PATH: windows-aarch64
+      RESULT_PATH_SUB: roswell
+
+    environment: SET_VERSION
+
+    steps:
+      - run: git config --global core.autocrlf false
+      - uses: actions/checkout@v2
+      - uses: msys2/setup-msys2@v2
+        with:
+          msystem: CLANGARM64
+          path-type: inherit
+          release: true
+          update: true
+          install: >-
+            base-devel
+            p7zip
+            autotools
+            mingw-w64-clang-aarch64-toolchain
+            mingw-w64-clang-aarch64-autotools
+      - name: Run MSYS2 once
+        shell: msys2 {0}
+        run: |
+          pwd
+          echo $MSYSTEM
+          echo $MSYSTEM_CARCH
+          echo $PATH
+      - name: Build
+        shell: msys2 {0}
+        run: |
+          clang -v
+          ./bootstrap
+          CC=clang ./configure
+          make
+          make install
+          make pack.zip
+      - name: Upload
+        env:
+          GITHUB_OAUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        shell: msys2 {0}
+        run: |
+          make -f scripts/Makefile latest-version win-upload

.gitignore

@@ -1,15 +1,24 @@
 *.o
 *.dirstamp
+*.AppImage
+*.fasl
 .deps
+.env
 src/ros
 src/ros.exe
+src/html_sbcl
+src/html_sbcl.exe
 src/gend.h
-src/gen
-src/gen.exe
-Makefile
+/Makefile
+/src/Makefile
+/documents/Makefile
 Makefile.in
 configure
 config.status
+config.h
+config.h.in
+install-sh
+missing
 compile
 aclocal.m4
 autom4te.cache
@@ -17,5 +26,10 @@ stamp-h1
 depcomp
 config.log
 scripts/roswell*
-scripts/homebrew
-documents/*.1
+*~
+#*
+/documents/.sass-cache/
+/documents/html/ros.css.map
+/documents/ros.css.map
+*TAGS
+.vscode

.travis.yml

@@ -1,19 +1,69 @@
-language: objective-c
+language: c
+sudo: false
+dist: xenial
+env:
+  global:
+    - PATH=~/.roswell/bin:/home/linuxbrew/.linuxbrew/bin:$PATH
+    - ROSWELL_BRANCH=$TRAVIS_BRANCH
+    - ROSWELL_INSTALL_DIR=$HOME/.roswell
+    - ROSWELL_REPO=https://github.com/${TRAVIS_REPO_SLUG}
+os:
+  - linux
 
+jobs:
+  include:
+      - os: linux
+        arch: arm64
+        env: LISP=sbcl-bin
+        addons:
+          apt:
+            packages:
+              - libcurl4-openssl-dev
+      - sudo: required
+        name: "valgrind"
+        os: linux
+        install:
+          - sh bootstrap
+          - CFLAGS="-g -O0" ./configure --disable-dependency-tracking --disable-maintainer-mode
+          - make
+          - sudo make install
+          - make maintainer-clean
+        script:
+          - ros setup
+          - valgrind --leak-check=yes ros config
+          - ros config
+        addons:
+          apt:
+            packages:
+              - valgrind
+
+#branches:
+#  except:
+#      - /^v[0-9]/
+
+addons:
+  apt:
+    packages:
+      - libc6-i386
+#      - gcc-multilib
+
+before_install:
+  - date
+install:
+  - $SETARCH sh ./scripts/install-for-ci.sh
 script:
-  - find . \( -name \*.c -o -name \*.h \) -type f|xargs wc -l
-  - find . \( -name \*.lisp -o -name \*.ros \) -type f|xargs wc -l
-  - sh bootstrap
-  - ./configure
-  - make -j4
-  - sudo make install
-  - ros version
-  - ros -v setup
-  - ros -v run -- --version
-  - ros install sbcl
-  - ros -v run -- --version
-  - ros install ccl-bin
-  - ros -v run -- --version
-  - ros config
-  - man -Pcat ros
-  - make test
+  - $SETARCH ros version
+  - $SETARCH ros version=t run
+  - $SETARCH ros install prove
+  - $SETARCH run-prove roswell-test.asd 2>&1
+  - $SETARCH ros -q run && [`ros -q run 2>&1` == ""]
+  - if [ "$LISP" = "sbcl-bin" ] && [ x$ALLOW_FAILURES != x ]; then
+       if [ $ALLOW_FAILURES = YES ]; then
+         ros sbcl.patchless=t install sbcl;
+       else
+         ros install sbcl --sbcl-bin;
+         [`ros -e "(ros:ignore-shebang)" -e '(loop for x in (directory "src/lisp/*.ros") do (load x))' 2>&1` == ""];
+       fi;
+       make -C t/tree-shaker ;
+    fi
+  - $SETARCH ros config

COPYING

@@ -1,4 +1,4 @@
-Copyright (c) 2014-2015 SANO Masatoshi
+Copyright (c) 2014-2022 SANO Masatoshi
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

ChangeLog

@@ -1,3 +1,766 @@
+roswell (26.02.116-1) unstable; urgency=low
+
+  * Fix: failure to load djula on sbcl 2.5.11 environment.
+  * Fix: declaration-definition disagreement in src/cmd-run.h. (reported by ItsMeForLua and fixed by Trichiurus-lepturus)
+  * Fix: support sbcl lisp-implementation-version returning '2.4.10.roswell'.
+  * Change: Allegro CL upgraded to release 11.0express. (by Xiaming Chen)
+  * Change: ros command return 1 when script file not found.
+  * Change: ros fmt rewritten to use cl-indentify.
+
+ -- SANO,Masatoshi <snmsts@gmail.com>  Tue, 24 Feb 2026 06:39:51 +0900
+
+roswell (24.10.115-1) unstable; urgency=low
+
+  * New: tested on darwin/ppc environment.
+  * New: tested on netbsd/aarch64 environment.
+  * Fix: absolute path error on Windows (by Ashton Fagg)
+  * Fix: build error on non Windows environment with windres (reported by Richard DW Redcroft)
+  * Fix: error message in build (by Rongsong Shen)
+
+ -- snmsts <snmsts@gmail.com>  Wed, 16 Oct 2024 15:06:42 +0900
+
+roswell (23.10.14.114-1) unstable; urgency=low
+
+  * New: use patchelf to support for distributions like guix/nix.
+  * Fix: 'ros.installing' feature not work. (reported by Fukamachi)
+  * Fix: fix windows build script (by Jeongsoo, Park)
+  * Fix: ros fmt  (by Daniel Jay Haskin)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Tue, 03 Oct 2023 12:57:11 +0000
+
+roswell (22.12.14.113-1) unstable; urgency=low
+
+  * Fix: release CI for debian package.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sat, 10 Dec 2022 23:14:05 +0800
+
+roswell (22.12.14.112-1) unstable; urgency=low
+
+  * New: Support cab extract on windows.
+  * New: `ros template path template-name files` to show native for template file.
+  * Fix: crush when download file smaller than 74bytes.
+  * Fix: `dynamic-space-size` parameter accepted by `ros build`.
+  * Fix: install old implementation when new quicklisp dist used. (reported by Alexander Artemenko)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Tue, 06 Dec 2022 21:59:43 +0900
+
+roswell (21.10.14.111-1) unstable; urgency=low
+
+  * New: 'ros client' to send oneshot message to lisp server. only support swank for now.
+  * New: 'ros install clisp-head' to install binary clisp.
+  * Changes: a lot related to ci.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Fri, 15 Oct 2021 15:38:51 +0900
+
+roswell (21.06.14.110-1) unstable; urgency=low
+
+  * Change: 'ros version' to show sbcl-bin-variant.
+  * Fix: support Allegro again it was broken because of uri change (by TANIGUCHI Masaya)
+  * Fix: install asdf at FreeBSD (Reported by C-Entropy)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Thu, 24 Jun 2021 17:15:59 +0900
+
+roswell (21.05.14.109-1) unstable; urgency=low
+
+  * New: 'ros install clasp-bin' implemented only tested on ubuntu 20.04
+  * New: './configure --with-sbcl-bin-variant=string' implemented for variants '-glibc2.10', '-musl' is prepared now.
+  * Fix: support for msi structure change?(reported by Aratrik Pal)
+  * Change: read tsv table to get current version of sbcl-bin instead of parsing html.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Wed, 12 May 2021 13:01:28 +0000
+
+roswell (21.01.14.108-1) unstable; urgency=low
+
+  * New: 'ros serve swank' to launch swank server.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Tue, 26 Jan 2021 01:05:07 +0000
+
+roswell (20.06.14.107-1) unstable; urgency=low
+
+  * New: 'ros ecl-config' to lunch ecl-config.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 29 Jun 2020 17:23:52 +0800
+
+roswell (20.05.14.106-1) unstable; urgency=low
+
+  * New: 'ros follow-dependency=t install foo/bar' to recursive install submodules. (Requested by Bo Yao and cxxxr)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Thu, 21 May 2020 17:01:53 +0800
+
+roswell (20.04.14.105-1) unstable; urgency=low
+
+  * Change: fix uname result at compiletime.
+  * New: prepare 'ros install sbcl-source' for install source.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Thu, 16 Apr 2020 14:27:15 +0800
+
+roswell (20.01.14.104-1) unstable; urgency=low
+
+  * New: 'ros variant=glibc2.10 install sbcl-bin' supported for old system like centos 6.
+  * New: 'ros sbcl-bin.version=system setup' to setup using system installed sbcl.
+  * Change: read tsv table to get current version of sbcl-bin instead of parsing html.
+  * Change: generatedd template by 'ros init' might include "(ql:quickload '())" supported from quicklisp client  2020-01-04.
+  * Fix: Memory leak related to fail on setup.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Wed, 29 Jan 2020 14:46:37 +0800
+
+roswell (19.12.13.103-1) unstable; urgency=low
+
+  * New: invoke last system entry point if nothing provided. (try 'ros -s http.server' after ros install snmsts/http.server)
+  * Change: check glibc for supported environment. ('ros roswell-internal-use version glibc')
+  * Change: head for github repo exists or not.
+  * Fix: msiexec path problem (by luca regini)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 23 Dec 2019 13:00:48 +0800
+
+roswell (19.09.12.102-1) unstable; urgency=low
+
+  * New: 'ros -v uri=http://prdownloads.sourceforge.net/sbcl/sbcl-1.5.5-x86-64-linux-binary.tar.bz2 install sbcl-bin' to install sbcl-bin from specified uri
+  * New: tested with openindiana
+  * New: roswell.util::local-projects-searcher implemented for remove directory start with "."
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 30 Sep 2019 01:09:19 +0800
+
+roswell (19.08.10.101-1) unstable; urgency=low
+
+  * New: support npt (new common lisp implementation !!)
+  * Change: 'ros which' return 1 when it is not found system
+  * Change: Updated clasp 2019-07-09. by gos-k
+  * Change: some sbcl option set via envvar (reported by Fukamachi)
+  * Fix: CircleCI's working directory in install-for-ci  (by Neil Lindquist)
+  * Fix: infinit loop when 'ros install asdf' (reported by @JotaPe)
+  * Fix: tried install on armv5tejl box
+  * Fix: failure installation slime on windows 10 64bit (by Akihide Nano)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Wed, 21 Aug 2019 16:11:23 +0800
+
+roswell (19.06.10.100-1) unstable; urgency=low
+
+  * Change: ros update github installed repo would force update (reported by Hamayama)
+  * Fix: deal with project.lisp which are not generated by ros project.
+  * New: support travis windows sbcl-bin only.
+  * Change: install-for-ci.sh use debian package to install roswell.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Fri, 21 Jun 2019 21:40:55 +0800
+
+roswell (19.05.10.99-1) unstable; urgency=low
+
+  * New: appimage build script by TANIGUCHI Masaya
+  * New: ignore ssl verifycation option by lambdasakura
+  * New: 'make brewpr' for update homebrew.
+  * New: prepare init-hook (WIP)
+  * Fix: Autotools fix for mingw64 environment by Tom Rake
+  * Fix: sbcl dump by by Masataro Asai
+  * Fix: use correct lispworks command line argument -eval by Jingtao Xu
+  * Fix: 'ros dump' error when sbcl-bin updated.
+  * Change: 'ros install' would check local project ealier than builtin implement installer.
+  * Change: version scheme 19.4.10.98 -> 19.05.10.99 month would always consume 2 digits.
+  * Change: Updated clasp 2019-03-30. by gos-k
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 20 May 2019 16:09:46 +0800
+
+roswell (19.4.10.98-1) unstable; urgency=low
+
+  * Fix: enable to pass implementation option from 'ros build' command. (reported by Kanai Hiroki)
+  * Fix: Travis on clone issue solved by ROSWELL_REPO definition in .travis.yml by Tom Rake.
+
+ -- snmsts <snmsts@gmail.com>  Mon, 01 Apr 2019 07:52:05 +0200
+
+roswell (19.3.10.97-1) unstable; urgency=low
+
+  * Change: Updated clasp 2019-01-19. by gos-k
+  * Fix: Ensure that path is checked for in update-hg and update-git. by jsjolen
+  * Fix: dump core fails at initial launch.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Tue, 05 Mar 2019 17:24:43 +0800
+
+roswell (19.1.10.96-1) unstable; urgency=low
+
+  * New: 'ros checkout' to checkout from remote repository (WIP)
+  * Change: Updated clasp 2018-11-28. by gos-k
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Wed, 02 Jan 2019 11:16:55 +0800
+
+roswell (18.10.10.95-1) unstable; urgency=low
+
+  * Fix: ignore .sbclrc when 'ros install sbcl'
+  * Fix: ECL build broken.(reported by Anton Vodonosov)
+  * Change: hopefully improve zlib notification (reporetd by Michał Herda)
+  * Change: add bzip2 dependency on debian package.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Tue, 09 Oct 2018 17:33:39 +0800
+
+roswell (18.9.10.94-1) unstable; urgency=low
+
+  * Fix: some fix applied (by Hamayama)
+  * New: 'ros make-depends' to prepare dependency file for Make
+  * Change: local-projects are not edited when 'QUICKLISP_HOME' are set (requested by Fukamachi)
+  * Change: 'ros install' support 'ros project' generated system.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 17 Sep 2018 00:37:36 +0900
+
+roswell (18.8.10.93-1) unstable; urgency=low
+
+  * Fix: update msys2 version (by Satoaki MIYAO)
+  * Fix: countdown version number of sbcl-bin wasn't supported more than 10 (by Yuya Kono)
+  * Fix: lispdir fix for windows (by Hamayama)
+  * Fix: segfault in 'ros setup' at first time invocation.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Wed, 15 Aug 2018 15:34:32 +0900
+
+roswell (18.6.10.92-1) unstable; urgency=low
+
+  * New: new dist support mkcl
+  * New: ros dist (WIP)
+  * Change: Updated clasp 2018-05-17. by gos-k
+  * Fix: Fix windows build.
+  * Fix: setgroups before setuid for fix RPM packaging by Bheesham Persaud
+  * Fix: launch of system SBCL by Olivier Certner
+  * Fix: dump-sbcl for newer sbcl. by Masataro Asai
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Tue, 19 Jun 2018 14:55:56 +0900
+
+roswell (18.4.10.91-1) unstable; urgency=low
+
+  * Fix: support github chnaging format.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 23 Apr 2018 13:46:27 +0900
+
+roswell (18.4.10.90-1) unstable; urgency=low
+
+  * Change: Updated clasp 2018-04-01. (by gos-k)
+  * New: lispworks support (by cxxxr)
+  * Fix: ignore suffix to support OpenBSD installation.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Tue, 03 Apr 2018 13:42:57 +0900
+
+roswell (18.3.10.89-1) unstable; urgency=low
+
+  * New: 'ros balus' for delete config.
+  * New: 'ros templete' implementation (by eshamster)
+  * Fix: 7zip installation failure (by Akihide Nano)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Tue, 06 Mar 2018 15:24:44 +0900
+
+roswell (18.1.10.87-1) unstable; urgency=low
+
+  * New: implement 'ros install sly' works like 'ros install slime'.
+  * Change: Updated clasp 2017-12-20.
+  * Fix: Don't swallow exit code on Windows (by Wilfredo Velázquez-Rodríguez)
+  * Fix: error installing allegro if Volume mounted on path which include Spaces (by Antonio Juan Querol)
+  * Fix: env bug.
+  * New: 'ros build script.ros --bundle-shared-object'  to bundle shared file to current directory.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 22 Jan 2018 00:25:21 +0900
+
+roswell (17.12.10.86-1) unstable; urgency=low
+
+  * Change: if you've already clone sbcl repo by 'ros install sbcl/git' your next compilation is not download src from archive but checkout via git.
+  * Change: Updated clasp 2017-12-12.
+  * Fix: some bug related env.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 18 Dec 2017 16:17:43 +0900
+
+roswell (17.11.10.85-1) unstable; urgency=low
+
+  * New: support using compiled init.lisp via ros compile-file.(not completed)
+  * New: ``ros install asdf``ed asdf lisp are automatically compiled.
+  * New: include patch files for compile sbcl.
+  * Change: to fix conflict with slash sepalated package-infered-system. github installed system are reffered 'user//repo' style.
+  * Change: Updated clasp 2017-11-05.
+  * Change: prevent doing mkdir when make. (reported by sheepduke #277)
+  * Fix: ``ros insall sbcl`` are success on windows (failed if sb-posix are loaded)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 20 Nov 2017 13:49:25 +0900
+
+roswell (17.10.10.84-1) unstable; urgency=low
+
+  * Change: ros install ecl accept branch name.
+  * Change: indirectly reffer asdf:*system-definition-search-functions*
+  * Change: Updated clasp 2017-10-12.
+  * New: add 'ros compile-file'
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Thu, 26 Oct 2017 05:43:17 +0900
+
+roswell (17.10.10.83-1) unstable; urgency=low
+
+  * New: ros exec command options would take care PATH. with this command,PATH setting is not required.
+  * Fix: support old FreeBSD box (by Payphone)
+  * Fix: asdf related errors.
+  * Change: Updated external clasp 5.0. (by gos-k)
+  * Change: Updated clasp 2017-09-17.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 11 Sep 2017 03:35:42 +0900
+
+roswell (17.9.10.82-1) unstable; urgency=low
+
+  * Fix: make `ros list installed`,`ros delete` and `ros use` better output.
+  * Change: Updated Clasp 2017-08-24. (by gos-k)
+  * Change: externals-clasp limit pjobs when memory are limited.
+  * Change: `-N` option to specify roswellenv.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 11 Sep 2017 03:35:42 +0900
+
+roswell (17.8.9.81-1) unstable; urgency=low
+
+  * New: environment switch facility.
+  * Change: Updated Clasp 2017-08-15. (by gos-k)
+  * fix: msys2 path (by jaccarmac)
+  * fix: initial proxy support (by egao1980)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Thu, 17 Aug 2017 03:34:21 +0900
+
+roswell (17.7.9.80-1) unstable; urgency=low
+
+  * New: 'ros fmt' become a beta stage.
+  * New: 'ros hg' introduced. almost same as 'ros git'.
+  * New: 'ros which' introduced. shows the path of systems.
+  * New: ``ros build`` takes asd file. prepare asd file which have same name with directory and ``ros build build`` ``ros build test`` .. so on.
+  * New: if roswell invoked directory have ``.roswell`` directory some information are refered from there.
+  * Change: Updated Clasp 2017-06-13. (by gos-k)
+  * Change: ``ros asdf delete/install/list/use`` -> ``ros delete/install/list/use asdf``
+  * Change: (opt "setup.time") are recorded when implementation installed.
+  * Change: 'ros build' take asd.
+  * Change: ``ros fmt`` rewriten (by cxxxr)
+  * Change: ``ros fmt`` takes asd file to know which files to indent.
+  * Fix: avoid segv at 'ros --' (by cxxxr)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sun, 16 Jul 2017 19:12:29 +0900
+
+roswell (17.6.9.79-1) unstable; urgency=low
+
+  * New: Introduced some image reduction options for `ros dump`.
+  * New: Introduced `ros template` command.
+  * Change: Updated Clasp 2017-06-03.
+  * Change: ``ros -l`` extensible via roswell:*load*.
+  * Change: ``ros install`` recursively install systems.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sun, 18 Jun 2017 15:46:59 +0900
+
+roswell (17.5.8.78-1) unstable; urgency=low
+
+  * Bugfix: release script is not working sufficiently.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sun, 21 May 2017 14:18:12 +0900
+
+roswell (17.5.8.77-1) unstable; urgency=low
+
+  * New: `ros update project` support projects using hg by (implemented by gos-k)
+  * New: `ros list git` to show which project are installed via git
+  * New: `ros git` command.
+  * New: `ros update quicklisp` supported
+  * Change: download sbcl-bin from github/roswell/sbcl_bin don't access sourceforge anymore.
+  * Change: Updated Clasp 2017-05-20.(by gos-k)
+  * Change: external-clasp installation are parallelized (by TANIGUCHI Masaya)
+  * Change: speedup by using dump when ``ros build``.
+  * Change: `ros 32=t shell` will launch 32bit will launch 32bit shell
+  * Change: `ros asdf use no` to cancel choice of asdf version.
+  * Fix: `roswell:script` errored without `(roswell:ensure-asdf)` (reported by Alexander Artemenko)
+  * Fix: when `system_` return NULL cause segfault on windows (reported by fukamachi)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sat, 20 May 2017 22:02:57 +0900
+
+roswell (17.4.8.76-1) unstable; urgency=low
+
+  * New: 'ros update system [systems...]' to pull upstream and install it.
+  * New: 'ros subcommand' invokes ros-subcommand if possible.
+  * New: new option for 'ros install sbcl' 'linkable-runtime' and 'dynamic-core'.
+  * Change: 'ros asdf install version' can specify version by SHA.
+  * Change: Updated Clasp 2017-04-15.(by gos-k)
+  * Fix: change ffcall uri.(was blocked)
+  * Change: change the directory from ~/.roswell via $ROSWELL_HOME.
+  * Change: change sigsegv version for clisp from 2.10 to 2.11.
+  * Change: 'ros install allegro' will install 10.1express.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Wed, 26 Apr 2017 20:32:44 +0900
+
+roswell (17.3.8.75-1) unstable; urgency=low
+
+  * Change: better clasp support. (clasp version are chosen by gos-k)
+  * Change: Enable CCL to run on FreeBSD.(by FungusHumungus)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Wed, 29 Mar 2017 07:38:44 +0900
+
+roswell (17.2.8.74-1) unstable; urgency=low
+
+  * New: initial support clasp. 'ros install clasp' and 'ros run'. (clasp version are chosen by gos-k)
+  * New: 'ros install sbcl/git' to clone from git repo and install it.
+  * Change: 'ros emacs' take -L option (reported by Alexander Artemenko)
+  * Change: core compression will be used for sbcl.
+  * Change: if `*default-pathname-defaults*`/.roswell/local-projects/ exists ~/.roswell/local-projects/ are not treated.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Thu, 23 Feb 2017 13:10:22 +0900
+
+roswell (17.1.8.73-1) unstable; urgency=low
+
+  * New: introduce 'ros shell' for windows
+  * Change: decline makeflags 'ros install clisp' (by Masataro Asai)
+  * Change: 'ros help' format changed.
+  * Change: stop 'ros build' when file overwrite scripts itself.(reported by Thomas Schaper)
+  * Change: check SUDO_USER only when uid=0
+  * Fix: when loading system provided by quicklisp with "/" (reported by Alessandro Serra)
+  * Fix: Return code of scripts and build executable differs (reported by @peccu)
+  * Fix: Segmentation fault caused by a missing option argument.(by Hiroyuki Tanaka)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sat, 28 Jan 2017 23:31:33 +0900
+
+roswell (16.12.8.72-1) unstable; urgency=low
+
+  * New: asdf integration. you can download from github like (ql:quickload "roswell/roswell")
+  * Change: module function are used everywhere.
+  * Change: add CWD/.roswell/local-projects/ to ql:*local-project-directories* when startup
+  * Change: subcommand swank are canceled. now you can install slime via 'ros install slime'
+  * Change: ql:quickload without silent when launched with -v (issued by Anton Vodonosov)
+  * Change: rename packages 'ros.*' -> 'roswell.*'
+  * Change: ros script for subcommand doesn't take subcommand name.
+  * Fix: ros install sbcl breaks when using other lisp impls (reported by Oliver Markovic)
+  * Fix: tested some feature on win32. maybe ccl-bin fixed?
+  * Fix: current package differ when launchd as script or build.(reported by Jacek Złydach)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Wed, 28 Dec 2016 02:51:21 +0900
+
+roswell (16.12.7.71-1) unstable; urgency=low
+
+  * New: automatically dump when subcommand or .roswell/bin/*.ros is newer or not exists.
+  * New: introduce '-A' '+A' option to use downloaded ASDF
+  * Change: ros:ensure-using-downloaded-asdf -> ros:asdf
+  * Change: helper.el to refer parse confdir directory to decide which swank to use.
+  * Change: use 'ql-http:*fetch-scheme-functions*' to patch quicklisp download.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Fri, 16 Dec 2016 12:37:15 +0900
+
+roswell (16.11.7.70-1) unstable; urgency=low
+
+  * New: new versioning rule.
+  * Change: implement 'sbcl.patchless=t' to test without patch.
+  * Change: 'ros install' would make dump only if install something.
+  * Change: change sbcl-bin download uri.
+  * Change: download sbcl-bin from github when using install-for-ci.sh.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Fri, 18 Nov 2016 01:43:45 +0900
+
+roswell (0.0.6.69-1) unstable; urgency=low
+
+  * New: 'ros install sbcl --sbcl-bin' to install sbcl as sbcl-bin
+  * New: 'ros.install:*checkout-default*' is introduced it handles 'ros install' checkout.
+  * New: 'ros install ./' would copy current directory and load asd which have the directory.
+  * New: patch for sbcl/1.3.11 build.
+  * Change: 'ros install' takes multiple target to install.
+  * Change: 'ros init' template now have '(ros:ensure-asdf)'
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Wed, 02 Nov 2016 23:27:29 +0900
+
+roswell (0.0.6.68-1) unstable; urgency=low
+
+  * New: 'ros dump' support cmucl (by Masataro Asai)
+  * Fix: 'ros -s' occur error (reported by Eitaro Fukamachi)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Fri, 21 Oct 2016 18:28:00 +0900
+
+roswell (0.0.6.67-1) unstable; urgency=low
+
+  * Fix: 'ros list versions' works fine. (reported by ssaavedra)
+  * Change: supported 'ros install user/project/tag' form.
+  * Change: Try not load asdf when just launched.
+  * Improve: retry downloading when archive failed to download.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Fri, 07 Oct 2016 03:03:31 +0900
+
+roswell (0.0.6.66-1) unstable; urgency=low
+
+  * Change: add quickload template on 'ros init' (by Masataro Asai)
+  * Improve: CI script edited to install libc6-i386 automatically.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Fri, 09 Sep 2016 11:18:45 +0900
+
+roswell (0.0.6.65-1) unstable; urgency=low
+
+  * Improve: 'man ros-build' (by Masataro Asai)
+  * Improve: bind '*load-pathname*' when launched from binary (reported by Gareth Williams)
+  * Improve: show instructions on 'ros swank install' (reported by Masataro Asai)
+  * Imporve: prepare for -M
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sun, 14 Aug 2016 15:49:19 +0900
+
+roswell (0.0.6.64-1) unstable; urgency=low
+
+  * New: Support Allegro Common Lisp 10 Express edition via 'ros install alisp'
+  * New: Support CMUCL by 'ros install cmu-bin'
+  * New: 'ros install roswell/jscl' will introduce jscl (partial support)
+  * New: 'ros run' changed to scriptable see 'https://github.com/roswell/jscl'
+  * Change: Muted backtrace when emacs is not found. (by mpsyco)
+  * Change: Show quicklisp information when 'ros version'
+  * Change: Ignore .roswell/init.lisp when setup.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Fri, 01 Jul 2016 12:08:16 +0900
+
+roswell (0.0.6.63-1) unstable; urgency=low
+
+  * New: support cmu-bin for install and run.
+  * Improve: 'ros swank' implementation still WIP.
+  * Bugfix: SBCL_HOME is not set correct when dump are specified.
+  * Bugfix: fix implicit 'ros setup' invoke error.
+  * Change: download internal command return positive number.
+  * Change: ros lisp files will be install in ${prefix}/etc.
+  * Change: 'ros setup' make dump which include files in ~/.roswell/bin and require dump 'roswell'
+  * Change: roswell download has user agent.
+  * Change: uri's are configurable.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sat, 21 May 2016 02:47:32 +0900
+
+roswell (0.0.5.62-1) unstable; urgency=low
+
+  * Change: stop using lock. (reported by gos-k that mkdir fails)
+  * Fix: envvar 'ROSWELL_HOME' was not working (reported by Alex Dunn)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 25 Apr 2016 14:51:59 +0900
+
+roswell (0.0.5.61-1) unstable; urgency=low
+
+  * Fix: broken caused by ECL's website change.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sat, 23 Apr 2016 18:24:26 +0900
+
+roswell (0.0.5.60-1) unstable; urgency=low
+
+  * Change: quicklispdir changed ~/.roswell/impls/ALL/ALL/quicklisp -> ~/.roswell/lisp/quicklisp.
+  * Change: completion file installantion disabled.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sat, 23 Apr 2016 09:52:27 +0900
+
+roswell (0.0.5.59-1) unstable; urgency=low
+
+  * Fix:Error when 'ros delete IMPL'.
+  * Change: separate Windows specific function from blabla.c to blabla_windows.c
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 18 Apr 2016 03:28:03 +0900
+
+roswell (0.0.5.58-1) unstable; urgency=low
+
+  * Change: 'ros install sbcl --without-install' install just download and expand sbcl source.It's good with sbcl-bin.
+  * Change: 'ros config','ros help' are reimplemented in lisp.
+  * Change: lisp/install.lisp was specially treated ros script. Now it is just a ros script.
+  * Change: 'ros install quicklisp' are reimplemented in lisp.
+  * Change: use plump insteand of cl-html-parse.
+  * Fix: make 'ros setup' not to use dump file. It breaks everything sometime.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sun, 10 Apr 2016 12:57:43 +0900
+
+roswell (0.0.4.57-1) unstable; urgency=low
+
+  * New: support installing abcl-bin try 'ros install abcl-bin'
+  * New: on x86-64 platforms it support 32bit ccl if 'ros ccl.bit=32 -L ccl-bin run' or 'ros config ccl.bit 32' before use ccl
+  * Improve: File generated by 'ros init' now has modeline for vim.(by Kono Yuya)
+  * Imporve: Comment which encourage users to write description about the script (by Masataro Asai)
+  * Improve: better support for cmucl.
+  * Improve: install-for-ci.sh will fail when it fail to install implementation.
+  * Experiment: 'ros fmt' to indent all files in the directory (using emacs and it's too slow.)
+  * Change: edit options for install sbcl. type 'ros help install sbcl'
+  * Change: if 'main' function return a number then the number would used as a return code of the script.
+  * Change: 'sb-simd-pack' are enabled as a default when 'ros install sbcl'
+  * Change: Revises and corrects grammar mistakes in the readme (by Smith Dhumbumroong)
+  * Change: Swap param for 'ros delete dump' to take (impl dump-name) to (dump-name [impl]).
+  * Change: 'ros setup' doesn't make roswell.core when everything are up to date.
+  * Change: use more plump rather than cl-html-parse.
+  * Fix: support loading asdf ecl and abcl. (reported by akanouras)
+  * Fix: ecl's archive uri are changed.
+  * Fix: core dumped when given parameter to ros like 'ros a=b c=d'
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sat, 12 Mar 2016 18:38:30 +0900
+
+roswell (0.0.3.56-1) unstable; urgency=low
+
+  * Fix: 'ros -L clisp run' doesn't invoke repl.
+  * New: bash completion. (by Masataro Asai)
+  * New: zsh completion. (by Kiwamu Ishikura)
+  * Channge: refactoring.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Thu, 28 Jan 2016 05:26:56 +0900
+
+roswell (0.0.3.55-1) unstable; urgency=low
+
+  * New: chm file are generated for windows platform.
+  * New: 'ros asdf' introduced.
+  * Improve: document html have now link. (by Masataro Asai)
+  * Change: transfered from snmsts/roswell to roswell/roswell.
+  * Change: 'ros build' support shebang line.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sun, 10 Jan 2016 22:36:11 +0900
+
+roswell (0.0.3.54-1) unstable; urgency=low
+
+  * New: `ros:ensure-using-downloaded-asdf` are introduced.
+  * New: Use the latest ASDF for CI when $ROSWELL_LATEST_ASDF is true.
+  * Change: Use pandoc to to generate documents man and html.
+  * Improve: Better support for armv7l.
+  * Improve: More documentation.(by Masataro Asai)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sat, 19 Dec 2015 20:55:22 +0900
+
+roswell (0.0.3.53-1) unstable; urgency=low
+
+  * New: support installing ecl.
+  * Improve: show error message when download page are not include 'sbcl'.
+  * Change: 'ros init' make a file with package.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Thu, 26 Nov 2015 13:53:45 +0900
+
+roswell (0.0.3.52-1) unstable; urgency=low
+
+  * Improve: try support arm64.(just uname-> architecture)
+  * Improve: use msys2 are alredy running, use it.
+  * Improve: write some 'man' files.
+  * Fix: 'ros build script' now don't take default option for sbcl. (reported by noctuid)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sat, 14 Nov 2015 19:02:06 +0900
+
+roswell (0.0.3.51-1) unstable; urgency=low
+
+  * Improve: hack compile-file*.
+  * Fix: pararel compile groff files.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Tue, 03 Nov 2015 23:05:53 +0900
+
+roswell (0.0.3.50-1) unstable; urgency=low
+
+  * New: New subcommand wait are implemented. 'ros wait' will good to use with server application.
+  * Fix: install-for-ci.sh update link to acl version to 10.0.
+  * Fix: armhf platform fixed.(by Pavel)
+  * Improve: re-install quicklisp init file if roswell updated.
+  * Improve: hack quicklisp to use roswell to extract tar.gz archive.
+  * Improve: messages and documentations are written and reviewed. (by Masataro Asai)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Fri, 30 Oct 2015 11:04:08 +0900
+
+roswell (0.0.3.49-1) unstable; urgency=low
+
+  * New: Now 'ros install sbcl' work on windows.
+  * Fix: fix determin architecture broken for armv7l reported by pimiento.
+  * Improve: start working install-for-ci.PS1.
+  * Improve: make all embeded URI configurable.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Thu, 08 Oct 2015 02:48:15 +0900
+
+roswell (0.0.3.48-1) unstable; urgency=low
+
+  * New: 'ros list versions impl' would show a version list installeable.
+  * Improve: check atom file for checking sbcl version.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sun, 20 Sep 2015 22:39:42 +0900
+
+roswell (0.0.3.47-1) unstable; urgency=low
+
+  * Fixed: Wrong implementation's dump  are listed when 'ros list dump'.
+  * Improve: 'ros help' can show more subcommands.
+  * Fixed: Ensure 'ros run' invoke 'ros setup' if not yet setup.then run sbcl-bin.
+  * Improve: Stop manual generation by default.
+  * Improve: configure script takes '--with-sbcl-bin-base=URI' to specify sbcl-bin's base uri (by Masaya TANIGUCHI)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 14 Sep 2015 01:02:43 +0900
+
+roswell (0.0.3.46-1) unstable; urgency=low
+
+  * Fixed: support ASDF 3.1.5 change asdf::*user-cache*
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Tue, 01 Sep 2015 19:01:28 +0900
+
+roswell (0.0.3.45-1) unstable; urgency=low
+
+  * Fixed: better algorithm to calc download progress.
+  * Fixed: Cache directory conflicts when sbcl and sbcl-bin are just same version.
+  * Fixed: wait for input forever when try to compile sbcl again on Darwin.
+  * Improve: Better support for CI service using Darwin.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sun, 30 Aug 2015 14:29:54 +0900
+
+roswell (0.0.3.44-1) unstable; urgency=low
+
+  * Fixed:Error when installing ros script from locally installed project.
+  * Improve: scripts/install-for-ci.sh improved especially ABCL and CMUCL.(by Eitaro Fukamachi)
+  * New: on windows, 'ros install msys2' implemented.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sat, 22 Aug 2015 14:23:18 +0900
+
+roswell (0.0.3.43-1) unstable; urgency=low
+
+  * Improve: Confirmed and some fix are applied for scripts/install-for-ci.sh
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sat, 15 Aug 2015 18:59:27 +0900
+
+roswell (0.0.3.42-1) unstable; urgency=low
+
+  * New: support new impls for 'ros run' (clisp ecl abcl cmu acl)
+  * Improve: Better error handling in 'ros build' (by Eitaro Fukamachi)
+  * Improve: scripts/install-for-ci.sh improved for new impls (by Eitaro Fukamachi)
+  * Change: 'ros install package' will call function bound to 'ros.install:*build-hook*'
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Thu, 13 Aug 2015 23:43:32 +0900
+
+roswell (0.0.3.41-1) unstable; urgency=low
+
+  * Change: use github to download sbcl source.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Fri, 31 Jul 2015 09:05:16 +0900
+
+roswell (0.0.3.40-1) unstable; urgency=low
+
+  * New: support download failure cause from upstream upload failure(?)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Thu, 30 Jul 2015 16:50:18 +0900
+
+roswell (0.0.3.39-1) unstable; urgency=low
+
+  * Change: revert automatically compile ros script facility (0.0.3.38-1).
+  * New: Handle SIGINT
+  * New: 'ros install sbcl/ccl-bin --without-install' will just download archive.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Tue, 28 Jul 2015 03:54:55 +0900
+
+roswell (0.0.3.38-1) unstable; urgency=low
+
+  * Change: add gist url for outage of sbcl.org.
+  * New: scripts/make-table.ros to make apropriate html file for roswell.
+  * Change: ros script are automatically compiled when it is installed by 'ros install hoge'.
+  * Improve: it's experimental implementation but setuid/setgid are properly done for 'ros setup'.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Thu, 23 Jul 2015 00:54:46 +0900
+
+roswell (0.0.3.37-1) unstable; urgency=low
+
+  * Change: Change progress bar width (for CMD.exe WIN32 platform)
+  * Bugfix: Fix typo of --load-system option (by Eitaro Fukamachi)
+  * Bugfix: 'ros -L ccl-bin run' fails when environment variable
+	'CCL_DEFAULT_DIRECTORY' are set (reported by Tatsuya BIZENN)
+  * Bugfix: fix some memory leaky part.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sun, 28 Jun 2015 10:32:04 +0900
+
+roswell (0.0.3.36-1) unstable; urgency=low
+
+  * Bugfix: Build fail without git.
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Mon, 22 Jun 2015 02:37:35 +0900
+
+roswell (0.0.3.35-1) unstable; urgency=low
+
+  * Improve: 'ros install' to support local project for roswell scripts.
+  * Improve: set ~/.roswell/local-projects/ as local project directory.
+  * New: support 'ros install sbcl --with-simd-pack'
+  * Bugfix: unset 'SBCL_HOME' when needed.
+  * Change: change 'ros dump list' to 'ros list dump'/ 'ros dump rm' to 'ros delete dump'
+  * Change: 'ros install project' don't check 'bin/' anymore. use 'roswell/' for install.
+  * Change: 'ros version' shows lispdir
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sun, 21 Jun 2015 23:06:52 +0900
+
+roswell (0.0.2.34-1) unstable; urgency=low
+
+  * Improve: 'ros use' take not only 'ros use impl/version' format but also take 'ros use impl' or 'ros use version'
+  * Improve: a lot of ugly messages are gone.  (by Eitaro Fukamachi)
+  * New: progress bar for non windows environment. (by Eitaro Fukamachi)
+
+ -- SANO Masatoshi <snmsts@gmail.com>  Sun, 14 Jun 2015 14:37:27 +0900
+
 roswell (0.0.2.33-1) unstable; urgency=low
 
   * Bugfix: 'ql-http:fetch' doesn't work well.(reported by Eitaro Fukamachi)

HACKING.md

@@ -0,0 +1,12 @@
+
+
+
+
+
+# default behavior for command line output
+
+if some command requires a subcommand and the subcommand is missing, output should be printed as follows:
+
+* auxilary information should be printed to the stderr. These are read by human.
+* list of candidates for the missing subcommand should be printed to the stdout. These are not only read by human, but also read by shell completion facility.
+

INSTALL.md

@@ -0,0 +1,34 @@
+## Dependencies
+
++ libcurl (both v3 and v4 should work) : used for downloading the lisp implimentation binaries etc.
++ automake (required when building from the source)
++ developmental headers of libcurl (required when building from the source)
+
+## Building from the Source
+
+Instruction for the system-wide installation follows:
+
+    $ git clone -b release https://github.com/roswell/roswell.git
+    $ cd roswell
+    $ sh bootstrap
+    $ ./configure
+    $ make
+    $ sudo make install
+
+**The installation directory is configurable** by specifying `--prefix` option to `./configure`. The default location is `/usr/local`. Actual binary and supporting files are finally installed into `$PREFIX/share/common-lisp/source/roswell/`.
+
+This is useful when using roswell as a backend of CI services (e.g. travis): When you specify a directory accessible without root permission, then you can switch to the new [container-based infrastructure](http://docs.travis-ci.com/user/workers/container-based-infrastructure/) for faster startup (of the tests). 
+
+This option can be used to write an installation script for CI services, but [we already provide such a script for Travis, CircleCI and Coverall](https://github.com/roswell/roswell/wiki/4.-Roswell-as-a-Testing-Environment-(Travis-CI-and-Coverall)))) using this feature. 
+
+Example:
+
+    $ git clone -b release https://github.com/roswell/roswell.git
+    $ cd roswell
+    $ sh bootstrap
+    $ ./configure --prefix ~/.local/
+    $ make && make install              ### in this case, no sudo is required!
+    $ ~/.local/bin/ros
+
+For the further information, see https://github.com/roswell/roswell/wiki
+

ISSUE_TEMPLATE.md

@@ -0,0 +1,37 @@
+
+For better utilizing the limited human resources, please include the following
+information when reporting an issue. Issues which do not follow the
+format may be immediately closed without review.
+
+## Environment
+
+```
+# result of evaluating
+uname -a
+ros --version    # if roswell runs successfully
+ros config
+```
+
+We may assign explanatory tags to bad questions instead of replying to it.
+See this famous text on how to ask good questions http://catb.org/~esr/faqs/smart-questions.html
+
+## How to reproduce the issue
+
+```sh
+
+
+```
+
+## Expected behavior
+
+```sh
+
+
+```
+
+## Actual result
+
+```sh
+
+```
+

Makefile.am

@@ -1,9 +1,188 @@
+roslispdir = @roslispdir@
+roslisppatchdir = @roslisppatchdir@
 SUBDIRS = src
-debian:
-	ros scripts/debian.ros
-prepare-release:
+
+if MANUAL_INSTALL
+MDS = ros.md ros-checkout.md ros-dump.md ros-init.md ros-install.md ros-list.md ros-setup.md ros-template.md \
+	ros-config.md ros-delete.md ros-emacs.md ros-run.md ros-use.md ros-wait.md ros-asdf.md ros-build.md ros-update.md \
+	ros-help.md ros-client.md ros-serve.md
+dist_man1_MANS = $(MDS:%.md=documents/man/%.1)
+endif
+
+if MANUAL_GENERATE
+SUBDIRS += documents
+endif
+
+ROSS = 	balus.ros \
+	build.ros \
+	checkout.ros \
+	client.ros \
+	config.ros \
+	compile-file.ros \
+	ecl-config.ros \
+	emacs.ros \
+	exec.ros \
+	dist.ros \
+	fmt.ros \
+	get.ros \
+	git.ros \
+	hg.ros \
+	run.ros \
+	setup.ros \
+	shell.ros \
+	version.ros \
+	wait.ros \
+	delete.ros \
+	dump.ros \
+	help.ros \
+	init.ros \
+	install.ros \
+	serve.ros \
+	update.ros \
+	list.ros \
+	make-depends.ros \
+	template.ros \
+	use.ros \
+	which.ros
+
+LISPS = helper.el \
+	init.lisp \
+	util.lisp util-main.lisp \
+	util-swank.lisp \
+	locations.lisp \
+	patch-quicklisp.lisp \
+	extend-quicklisp.lisp \
+	extend-quicklisp-system.lisp \
+	system.lisp \
+	\
+	build-ros.lisp build-asd.lisp \
+	\
+	client-swank.lisp \
+	util-config.lisp \
+	dist-list.lisp dist-clean.lisp dist-enable.lisp dist-disable.lisp dist-add.lisp \
+	dist-delete.lisp dist-use.lisp dist-versions.lisp dist-preference.lisp dist-default.lisp \
+	\
+	delete-default.lisp delete-dump.lisp delete-git.lisp delete-asdf.lisp \
+	delete-env.lisp \
+	\
+	util-dump.lisp \
+	dump-ccl.lisp dump-clisp.lisp \
+	dump-cmucl.lisp dump-ecl.lisp dump-sbcl.lisp \
+	\
+	help-install.lisp help-options.lisp help-run.lisp \
+	\
+	init-default.lisp init-env.lisp init-dist.lisp \
+	\
+	util-install.lisp util-install-quicklisp.lisp \
+	install+7zip.lisp install-abcl-bin.lisp install-allegro.lisp \
+	install-ccl-bin.lisp install-clasp-bin.lisp install-clasp.lisp \
+	install-clisp.lisp install-clisp-head.lisp \
+	install-cmu-bin.lisp install-dotcl-bin.lisp install-ecl.lisp \
+	install-quicklisp.lisp \
+	install-sbcl-bin.lisp install-sbcl.lisp install-sbcl-source.lisp \
+	install-sbcl-head.lisp \
+	install-slime.lisp install-sly.lisp \
+	install-lispworks.lisp install-mkcl.lisp \
+	install-npt.lisp \
+	install+externals-clasp.lisp install+ffcall.lisp \
+	install+msys2.lisp install+sigsegv.lisp install-asdf.lisp \
+	\
+	serve-default.lisp serve-swank.lisp \
+	update-git.lisp update-hg.lisp update-quicklisp.lisp update-default.lisp \
+	\
+	list-default.lisp \
+	list-dump.lisp list-git.lisp list-installed.lisp list-versions.lisp \
+	list-asdf.lisp list-env.lisp \
+	\
+	util-template.lisp \
+	\
+	util-use.lisp \
+	use-asdf.lisp use-env.lisp
+
+dist_roslisp_DATA = $(LISPS:%=lisp/%)
+dist_roslisp_SCRIPTS = $(ROSS:%=lisp/%)
+
+dist_roslisppatch_DATA = patch/sbcl-1.3.11.patch patch/sbcl-posix-tests.patch
+
+
+release-prepare:
 	ros scripts/release.ros prepare
+release-commit:
+	ros scripts/release.ros release-commit
+release-push:
+	ros scripts/release.ros release-push
+release-changelog:
+	grep not-yet-released ChangeLog 2>&1 > /dev/null || ros scripts/release.ros changelog
+release-ci:
+	ros scripts/release.ros release-ci
+
+winrelease: roswell/Makefile
+	mkdir -p roswell/lisp
+	mkdir -p roswell/documents
+	cp src/ros.exe roswell
+	cp lisp/*.lisp lisp/*.ros lisp/*.el roswell/lisp
+	cd documents;MSYSTEM=MINGW64 make roswell.chm
+	cp documents/roswell.chm roswell/documents
+	7z a Roswell-`if [ "$$MSYSTEM" = "MINGW64" ];then echo x86_64 ;elif [ "$$MSYSTEM" = "CLANGARM64" ];then echo aarch64; else echo i686; fi`.zip roswell/ros.exe roswell/lisp/*.* roswell/documents/roswell.chm
+debian:
+	ros debian/debian.ros all
 test:
-	ros -L sbcl-bin t/roswell.ros
-	ros -L ccl-bin t/roswell.ros
-.PHONY: debian prepare-release test
+	run-prove roswell-test.asd
+brewpr:
+	git pull
+	if [ `uname` = 'Darwin' ];then brew bump-formula-pr -v --url=https://github.com/roswell/roswell/archive/`git describe --abbrev=0 --tags`.tar.gz roswell; fi
+
+PACK = $(PACKAGE)-$(VERSION)-$(shell uname -s | tr '[A-Z]' '[a-z]' | sed -E 's/([^-]*).*/\1/')-$(ARCH)$(SBCL_BIN_VARIANT)
+
+roswell/Makefile:
+	rm -rf roswell
+	$(MKDIR_P) roswell
+	echo "prefix = /usr/local" > $@
+	echo "mandir = $$""(prefix)/share/man" >> $@
+	echo "all: ros$(EXEEXT)" >> $@
+	echo "install:" >> $@
+	echo "	mkdir -p $$""(prefix)/bin" >> $@
+	echo "	mkdir -p $$""(prefix)/etc/roswell/patch" >> $@
+	echo "	mkdir -p $$""(mandir)" >> $@
+	echo "	install -c ros$(EXEEXT) $$""(prefix)/bin" >> $@
+	echo "	install -c -m 644 $(ROSS:%=lisp/%) $(LISPS:%=lisp/%) $$""(prefix)/etc/roswell" >> $@
+	echo "	install -c -m 644 $(dist_roslisppatch_DATA) $$""(prefix)/etc/roswell/patch" >> $@
+	if [ 'x$(MDS)' != 'x' ]; then \
+		echo "	install -c $(MDS:%.md=man/%.1) $$""(mandir)" >> $@; \
+	fi
+	echo "" >> $@
+	echo "uninstall:" >> $@
+	echo "	rm -rf $$""(prefix)/etc/roswell" >> $@
+	echo "	rm -f $$""(prefix)/bin/ros$(EXEEXT)" >> $@
+	echo "	cd $$""(mandir);rm -f $(MDS:%.md=%.1)" >> $@
+
+$(PACK).tar.bz2: roswell/Makefile
+	$(MKDIR_P) roswell/patch
+	cd src;make ros$(EXEEXT)
+	cp src/ros$(EXEEXT) roswell
+	$(MKDIR_P) roswell/lisp
+	cp $(LISPS:%=lisp/%) roswell/lisp
+	cp $(ROSS:%=lisp/%) roswell/lisp
+	cp $(dist_roslisppatch_DATA) roswell/patch
+	if [ 'x$(MDS)' != x ]; then \
+		$(MKDIR_P) roswell/man; \
+		cp $(MDS:%.md=documents/man/%.1) roswell/man; \
+	fi
+	tar jcvf $(PACK).tar.bz2 roswell
+
+pack: $(PACK).tar.bz2
+
+WINPACK = roswell_$(VERSION)_$(shell if [ "$$MSYSTEM" = "MINGW64" ];then echo amd64 ;elif [ "$$MSYSTEM" = "CLANGARM64" ];then echo aarch64; else echo i686; fi)
+
+pack.zip: $(PACK).tar.bz2
+	7z a $(WINPACK).zip roswell
+	make $(WINPACK).zip.hash
+
+$(WINPACK).zip.hash:
+	echo "md5sum	"`md5sum -t $(WINPACK).zip` > $(WINPACK).zip.hash
+	echo "sha1sum	"`sha1sum -t $(WINPACK).zip` >> $(WINPACK).zip.hash
+	echo "sha256sum	"`sha256sum -t $(WINPACK).zip` >> $(WINPACK).zip.hash
+	echo "sha512sum 	"`sha512sum -t $(WINPACK).zip` >> $(WINPACK).zip.hash
+
+FORCE:
+.PHONY: release-prepare release release-push test winrelease debian pack roswell/Makefile FORCE

README.md

@@ -1,124 +1,161 @@
 # Roswell - Common Lisp environment setup Utility.
 
-[![Build Status](https://travis-ci.org/snmsts/roswell.svg?branch=master)](https://travis-ci.org/snmsts/roswell)
-[![Circle CI](https://circleci.com/gh/snmsts/roswell/tree/master.svg?style=svg)](https://circleci.com/gh/snmsts/roswell/tree/master)
+[![Build Status](https://travis-ci.org/roswell/roswell.svg?branch=master)](https://travis-ci.org/roswell/roswell)
+[![Quicklisp](http://quickdocs.org/badge/roswell.svg)](http://quickdocs.org/roswell/)
 
-This software is still beta. Basic interfaces are fixed, we beleive it works well on Unix-like platforms like Linux, Mac OS X and FreeBSD, but some parts are not implemented, not stable on other OSes yet.
+Roswell is a Lisp implementation installer/manager, launcher, and much more!
 
-## Description
-Roswell is a command line tool to install and manage Common Lisp implementations damn easily.
+Roswell started out as a command-line tool with the aim to make installing and managing Common Lisp implementations really simple and easy.
 
-## Limitations
-There's a lot of works should be done.
+Roswell has now evolved into a full-stack environment for Common Lisp development, and has many features that makes it easy to test, share, and distribute your Lisp applications.
+With Roswell, we aim to push the Common Lisp community to a whole new level of productivity.
 
-checkout [issue lists](https://github.com/snmsts/roswell/issues) if you have interest in what's lacking.
+Roswell is still in beta. Despite this, the basic interfaces are stable and not likely to change. Roswell currently works well on Unix-like platforms such as Linux, macOS and FreeBSD.
+Roswell also works on other operating systems, but currently some parts or features might be missing or unstable.
 
-## Installation
+Checkout [issues list](https://github.com/roswell/roswell/issues) if you are interested in what's lacking.
 
-### Building
+## Installation, Dependency & Usage
 
-#### For Mac OS X users
+See our [github wiki](https://github.com/roswell/roswell/wiki).
+We provide prebuilt binaries for homebrew on macOS, various Linux distributions and **also on Windows**.
+* [Linux](https://github.com/roswell/roswell/wiki/Installation#linux)
+* [FreeBSD](https://github.com/roswell/roswell/wiki/Installation#freebsd)
+* [macOS (via Homebrew)](https://github.com/roswell/roswell/wiki/Installation#mac-os-x--homebrew)
+* [Windows](https://github.com/roswell/roswell/wiki/Installation#windows)
+* [Building from Source](https://github.com/roswell/roswell/wiki/Installation#building-from-source)
 
-If you're on Mac OS X and wanna use Homebrew, use the custom tap:
+## Features
 
-    $ brew tap snmsts/roswell
-    $ brew install roswell
+[Feature comparison is available!](https://github.com/roswell/roswell/wiki/How-is-Roswell-different)
 
-#### For Arch linux users
+* Implementation Manager
+* Scripting environment (similar to cl-launch)
+* Building utility (similar to buildapp)
+* **Novel** : Easier setup for initializing a script
+* **Novel** : Better integration to the command-line interface (Bash completion, etc)
+* **Novel** : Infrastructure for bundling/installing the scripts to/from a quicklisp system
+* **Novel** : Better support for Windows environment (tested exhaustively)
+* **Novel** : Better integration to CI environment (e.g. [Travis-CI](https://github.com/roswell/roswell/wiki/Travis-CI), [CircleCI](https://github.com/roswell/roswell/wiki/Circle-CI), [Coveralls](https://github.com/roswell/roswell/wiki/Coveralls))
 
-You can install Roswell via AUR:
+## Usage
 
-    $ yaourt -S roswell
-
-#### others can build from source
-
-    $ git clone -b release https://github.com/snmsts/roswell.git
-    $ cd roswell
-    $ sh bootstrap
-    $ ./configure
-    $ make
-    $ sudo make install
-
-## How to use
-
-First of all, you can get sub-commands and command line options by this command:
-
-    $ ros
-
-### Installing Lisps
-
-If you want to install the newest released version of sbcl you can do it by:
-
-    $ ros install sbcl
-
-and if you have specific version like "1.2.0" to install then
-
-    $ ros install sbcl/1.2.0
-
-will install that version.
-
-You can get which version of SBCL are installed by this command:
-
-    $ ros list installed sbcl
-
-#### Supported Implementations and compile options.
-
-So far, `sbcl`,`sbcl-bin`,`ccl-bin` can be parameter for `ros install`.
-
-You can see compile option by
-
-    $ ros help install sbcl
-
-### Setting the default implementation used by ros
-
-    $ ros run -- --version
-
-will show you which version are used. You can change implementation by
-
-    $ ros use sbcl/1.2.3
-
-## Using roswell with Emacs and SLIME
-
-To setup slime with roswell, type like this
+Roswell has git-like subcommands which resemble that of cl-launch, buildapp.
 
 ```
-ros -Q -e '(ql:quickload :quicklisp-slime-helper)' -q
+$ ros
+Common Lisp environment setup Utility.
+
+Usage:
+
+   ros [options] Command [arguments...]
+or
+   ros [options] [[--] script-path arguments...]
+
+commands:
+   run       Run repl
+   install   Install a given implementation or a system for roswell environment
+   update    Update installed systems.
+   build     Make executable from script.
+   use       Change default implementation.
+   init      Creates a new ros script, optionally based on a template.
+   list      List Information
+   delete    Delete installed implementations
+   config    Get and set options
+   version   Show the roswell version information
+
+Use "ros help [command]" for more information about a command.
+
+Additional help topics:
+
+   options
+
+Use "ros help [topic]" for more information about the topic.
 ```
 
-Add lines like below to init.el
+### Managing/Installing Several Lisp Installations
 
-```lisp
-(load (expand-file-name "~/.roswell/impls/ALL/ALL/quicklisp/slime-helper.el"))
-(setq inferior-lisp-program "ros -L sbcl -Q run")
+    $ ros install               # displays a list of all installable implementations
+    
+    $ ros install sbcl-bin      # default sbcl
+    $ ros install sbcl          # The newest released version of sbcl
+    $ ros install ccl-bin       # default prebuilt binary of ccl
+    $ ros install sbcl/1.2.0    # A specific version of sbcl
+    
+    $ ros list installed sbcl   # Listing the installed implementations
+    $ ros run -- --version      # check which implementation is used
+    SBCL 1.2.15
+    $ ros use sbcl/1.2.3        # change the default implementation
+
+To use an implementation that was not installed by roswell, use i.e. `ros use sbcl/system`.
+
+The list of supported implementations continues to grow!
+
+By default roswell downloads the default stable lisp implementation (sbcl-bin). To use system implementation from the start run `ros lisp=sbcl-bin/system setup` before anything else.
+
+### Installing scripts
+
+It is also possible to install scripts using `ros install`:
+
+    $ ros install qlot            # will install a program from quicklisp
+    $ ros install fukamachi/qlot  # will install it from the GitHub
+
+To add installable scripts into the system, you need to put roswell
+scripts (files having `.ros` extensions) into a `roswell` subdirectory.
+Take a look at [qlot's roswell/qlot.ros](https://github.com/fukamachi/qlot/tree/master/roswell).
+
+
+### Scripting with Roswell
+
+```diff
+$ ros init
+Usage: ros init [template] name [options...]
+
+$ ros init fact
+Successfully generated: fact.ros
+
+$ emacs fact.ros
+## editing the fact.ros ...
+
+$ cat fact.ros
+#!/bin/sh
+#|-*- mode:lisp -*-|#
+#|
+exec ros -Q -- $0 "$@"
+|#
+
+(defun fact (n)
+  (if (zerop n)
+      1
+      (* n (fact (1- n)))))
+
+(defun main (n &rest argv)
+  (declare (ignore argv))
+  (format t "~&Factorial ~D = ~D~%" n (fact (parse-integer n))))
+
+$ ./fact.ros 10
+Factorial 10 = 3628800
 ```
 
-to load with `.sbclrc`
-
-```lisp
-(setq inferior-lisp-program "ros -L sbcl -Q -l ~/.sbclrc run")
-```
-
-Or, Just simply `ros emacs` would launch emacs with slime setup.
-
 ## Chef recipe for roswell
 
 [@Rudolph-Miller](https://github.com/Rudolph-Miller) is providing a Chef recipe for setting roswell up.
 
 - [Rudolph-Miller/chef-roswell](https://github.com/Rudolph-Miller/chef-roswell)
 
-## Roswell with Travis CI.
+## Roswell with CircleCI
 
-[@fukamachi](https://github.com/fukamachi) use Roswell with Travis CI.
+[@fukamachi](https://github.com/fukamachi) use Roswell with CircleCI.
 
-- [fukamachi/legion/.travis.yml](https://github.com/fukamachi/legion/blob/master/.travis.yml)
+- [fukamachi/legion/circle.yml](https://github.com/fukamachi/legion/blob/master/circle.yml)
 
-## Why we named it 'roswell'?
+## Naming Origin 'roswell'
 From ‘[made with secret alien technology](http://www.lisperati.com/logo.html)’.
 
 I felt making it easier to use Lisp for people is a kind of making opportunity for humanbeings to mingle with alien technology. I recall ‘roswell incident’ by the concept. I'm not sure what you feel.
 
 ## See Also
-+ [keens/cim](https://github.com/keens/cim) : similar project that is implemented in shellscript.I motivated to implement roswell by seeing this project.
++ [cl-launch](http://cliki.net/cl-launch) : influenced by the project of command line parameters design.
 
 ## Author
 SANO Masatoshi (snmsts@gmail.com)
@@ -126,12 +163,14 @@ SANO Masatoshi (snmsts@gmail.com)
 ## Contributors
  * Eitaro Fukamachi (e.arrows@gmail.com)
  * Tomoya KAWANISHI (chopsticks.tk.ppfm@gmail.com)
+ * Masataro Asai (guicho2.71828@gmail.com)
 
 ## Special Thanks to
  * Eitaro Fukamachi (e.arrows@gmail.com) for naming this project.
+ * Sunrin SHIMURA for [sionescu/cim](https://github.com/sionescu/CIM) that motivate me to start this project.
 
 ## Project
- * https://github.com/snmsts/roswell
+ * https://github.com/roswell/roswell
 
 ## License
-MIT
+Licensed under the MIT License.

circle.yml

@@ -1,18 +0,0 @@
-general:
-
-test:
-  post:
-    - sh bootstrap
-    - ./configure
-    - make -j4
-    - sudo make install
-    - ros version
-    - ros -v setup
-    - ros install sbcl
-    - ros -v run -- --version
-    - ros -v run -- --version
-    - ros install ccl-bin
-    - ros -v run -- --version
-    - ros config
-    - man -Pcat ros
-    - make test

configure.ac

@@ -1,12 +1,14 @@
 #                                               -*- Autoconf -*-
 # Process this file with autoconf to produce a configure script.
 
-AC_PREREQ([2.65])
-AC_INIT([roswell],[0.0.2.33],snmsts@gmail.com)
+AC_PREREQ([2.59])
+AC_INIT([roswell],[26.02.116],snmsts@gmail.com)
+CFLAGS=${CFLAGS=""}
+CXXFLAGS=${CXXFLAGS=""}
 
-AM_CONFIG_HEADER(config.h)
+AC_CONFIG_HEADERS(config.h)
 AC_CONFIG_FILES([Makefile src/Makefile])
-AC_CONFIG_SRCDIR([src/lsp.c])
+AC_CONFIG_SRCDIR([Makefile.am])
 AM_INIT_AUTOMAKE([foreign])
 AM_MAINTAINER_MODE([enable])
 
@@ -18,6 +20,29 @@ AM_PROG_CC_C_O
 # Checks for libraries.
 wwwlib=no
 
+test -z "$SED" && SED=sed
+
+AC_ARG_ENABLE([debug],
+  [AS_HELP_STRING([--enable-debug],
+                  [whether to include debug symbols (default is no)])],
+  [enable_debug=$enableval],
+  [enable_debug=no]
+)
+
+if test "x$enable_debug" = xyes; then
+  dnl Remove all optimization flags from CFLAGS
+  changequote({,})
+  CFLAGS=`echo "$CFLAGS" | $SED -e 's/-O[0-9s]*//g'`
+  CXXFLAGS=`echo "$CXXFLAGS" | $SED -e 's/-O[0-9s]*//g'`
+
+  CFLAGS=`echo "$CFLAGS" | $SED -e 's/-g[0-9]*//g'`
+  CXXFLAGS=`echo "$CXXFLAGS" | $SED -e 's/-g[0-9]*//g'`
+  changequote([,])
+
+  CFLAGS="$CFLAGS -g -O0"
+  CXXFLAGS="$CXXFLAGS -g -O0"
+fi
+
 AC_CHECK_LIB([wininet], [main],[LIBS="-lwininet $LIBS";wwwlib=yes],[])
 if test "x$wwwlib" = xno; then
   AC_CHECK_LIB([curl], [curl_global_init],[LIBS="-lcurl $LIBS";wwwlib=yes],[])
@@ -28,10 +53,96 @@ if test "x$wwwlib" = xno; then
   AC_MSG_ERROR([libcurl development files required]);
 fi
 
-AC_CHECK_HEADERS(windows.h)
+AC_CHECK_HEADERS(gnu/libc-version.h)
 
-# Checks for typedefs, structures, and compiler characteristics.
+AC_CHECK_HEADERS(windows.h,[with_windows=true])
+AM_CONDITIONAL([WITH_WINDOWS], [test "$with_windows" != ""])
+AC_CHECK_TOOL([WINDRES], [windres], [])
+AM_CONDITIONAL([WITH_WIN_ICON], [test "$WINDRES" != "" -a "$with_windows" != ""])
 
-# Checks for library functions.
+AC_CHECK_MEMBERS([struct dirent.d_type],,,[#include <dirent.h>])
+
+# Git is optional, so fail gracefully, build from tar may not have .git/
+AC_CHECK_PROG(GIT_CHECK,git,yes)
+AS_IF([test "x$GIT_CHECK" = xyes],
+      [AC_SUBST([git_version], `set -o pipefail ; { git describe  | sed -n -e 's/^.*-g//p' ; } 2>/dev/null || echo 'NO-GIT-REVISION'
+`,[git SHA1 for HEAD.])],
+      [AC_SUBST([git_version],[NO-GIT-REVISION])])
+
+AS_IF([test "x$GIT_CHECK" = xyes],
+      [AC_SUBST([git_version_long], `set -e | git describe --abbrev=7 --dirty 2>/dev/null || echo 'NO-GIT-REVISION'`, [long version for git source])],
+      [AC_SUBST([git_version_long], [NO-GIT-REVISION])])
+
+AC_CHECK_PROG(UNAME_CHECK,uname,yes)
+AS_IF([test "x$UNAME_CHECK" = xyes],
+      [AC_SUBST([uname_m], `set -e | uname -m`, [uname -m])],
+      [AC_MSG_ERROR([uname -m errored?])])
+
+AS_IF([test "x$UNAME_CHECK" = xyes],
+      [AC_SUBST([uname_s], `set -e | uname -s`, [uname -s])],
+      [AC_MSG_ERROR([uname -s errored?])])
+
+# Define rosdir and rospatchdir
+# TODO: Make these ./configure line options.
+# See https://www.gnu.org/prep/standards/html_node/Directory-Variables.html#Directory-Variables
+# Especially 'lispdir' example for emacs.
+roslispdir='${sysconfdir}/roswell'
+AC_SUBST(roslispdir)
+roslisppatchdir='${roslispdir}/patch'
+AC_SUBST(roslisppatchdir)
+
+# Change master uri for sbcl-bin
+AC_ARG_WITH([sbcl_bin_base],
+  [AS_HELP_STRING([--with-sbcl-bin-base=URI],[set URI for sbcl-bin [default=https://github.com/roswell/sbcl_bin/releases/download/]])],
+  [SBCL_BIN_URI=$withval],[SBCL_BIN_URI="https://github.com/roswell/sbcl_bin/releases/download/"])
+AC_DEFINE_UNQUOTED([SBCL_BIN_URI],["${SBCL_BIN_URI}"],[uri for sbcl master])
+
+AC_ARG_WITH([platformtsvl_base],
+  [AS_HELP_STRING([--with-platformtsv-base=URI],[set URI for sbcl-bin_uri.tsv [default=https://github.com/roswell/sbcl_bin/releases/download/files/sbcl-bin_uri.tsv]])],
+  [PLATFORM_TSV_URI=$withval],[PLATFORM_TSV_URI=https://github.com/roswell/sbcl_bin/releases/download/files/sbcl-bin_uri.tsv])
+AC_DEFINE_UNQUOTED([PLATFORM_TSV_URI],["${PLATFORM_TSV_URI}"],[uri for sbcl-bin_uri.tsv])
+
+AC_ARG_WITH([sbcl_bin_variant],
+  [AS_HELP_STRING([--with-sbcl-bin-variant=string],[set which variant for sbcl-bin [default=''] possible choices are '-glibc2.10', '-musl'.])],
+  [SBCL_BIN_VARIANT=$withval],[SBCL_BIN_VARIANT=""])
+AC_SUBST([SBCL_BIN_VARIANT], ["${SBCL_BIN_VARIANT}"])
+AC_DEFINE_UNQUOTED([SBCL_BIN_VARIANT],["${SBCL_BIN_VARIANT}"],[variant for sbcl-bin])
+
+AC_ARG_WITH([fixed_arch],
+  [AS_HELP_STRING([--with-fixed-arch=string],[set arch instead of on the fly detecting [default=''] possible choices are 'armhf', 'arm64'.])],
+  [FIXED_ARCH=$withval],[FIXED_ARCH=""])
+AC_SUBST([FIXED_ARCH], ["${FIXED_ARCH}"])
+AC_DEFINE_UNQUOTED([FIXED_ARCH],["${FIXED_ARCH}"],[arch to decide binary])
+
+# man file (ros.1) generation switch
+AC_ARG_ENABLE([manual_generation],
+  [AS_HELP_STRING([--enable-manual-generation],[generate manual if enabled])],
+  [case "${enableval}" in
+    yes) manual_generate=true ;;
+    no)  manual_generate=false ;;
+    *) AC_MSG_ERROR([bad value ${enableval} for --enable-manual-generate]) ;;
+   esac],[])
+AM_CONDITIONAL(MANUAL_GENERATE,[test x$manual_generate = x"true"])
+
+AC_ARG_ENABLE([manual_install],
+  [AS_HELP_STRING([--disable-manual-install],[install manual if enabled])],
+  [case "${enableval}" in
+    yes) manual_install=true ;;
+    no)  manual_install=false ;;
+    *) AC_MSG_ERROR([bad value ${enableval} for --enable-manual-install]) ;;
+   esac],[])
+AM_CONDITIONAL(MANUAL_INSTALL,[test x$manual_install != x"false"])
+
+AC_ARG_ENABLE([html_generation],
+  [AS_HELP_STRING([--enable-html-generation],[generate html if enabled])],
+  [case "${enableval}" in
+    yes) html_generate=true ;;
+    no)  html_generate=false ;;
+    *) AC_MSG_ERROR([bad value ${enableval} for --enable-html-generate]) ;;
+   esac],[])
+AM_CONDITIONAL(HTML_GENERATE,[test x$html_generate = x"true"])
+
+AM_COND_IF([MANUAL_INSTALL],
+           [AC_CONFIG_FILES([documents/Makefile])])
 
 AC_OUTPUT

debian/control

@@ -4,11 +4,11 @@ Priority: optional
 Maintainer: Masatoshi SANO <snmsts@gmail.com>
 Build-Depends: debhelper (>= 9)
 Standards-Version: 3.9.5
-Homepage: https://github.com/snmsts/roswell
-Vcs-Git: https://github.com/snmsts/roswell.git
+Homepage: https://github.com/roswell/roswell
+Vcs-Git: https://github.com/roswell/roswell.git
 
 Package: roswell
 Architecture: any
-Depends: ${shlibs:Depends}, ${misc:Depends}
+Depends: ${shlibs:Depends}, ${misc:Depends}, bzip2 , make
 Description: <insert up to 60 chars description>
  <insert long description, indented with spaces>

debian/copyright

@@ -1,9 +1,9 @@
 Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
 Upstream-Name: roswell
-Source: https://github.com/snmsts/roswell
+Source: https://github.com/roswell/roswell
 
 Files: *
-Copyright: 2014-2015 SANO Masatoshi
+Copyright: 2014-2022 SANO Masatoshi
 
 License: MIT
 

debian/debian.ros

@@ -0,0 +1,83 @@
+#!/bin/sh
+#|-*- mode: lisp -*-|#
+#|
+exec ros -Q -L sbcl-bin -- $0 "$@"
+|#
+(progn ;;init forms
+  (ros:ensure-asdf)
+  #+quicklisp (ql:quickload '(:jonathan :uiop :dexador) :silent t))
+
+(defpackage :ros.script.debian.3703769507
+  (:use :cl))
+(in-package :ros.script.debian.3703769507)
+
+(defvar *pwd* (make-pathname :defaults cl:*load-pathname* :name nil :type nil))
+(defvar *package-name* "roswell")
+(defvar *stab-version* "99.99.99.99")
+(defun get-newest-url (base)
+  (let ((branch (or (ros:getenv "CIRCLE_BRANCH")
+                    (ros:getenv "TRAVIS_BRANCH"))))
+    (if branch
+        (format nil "https://github.com/~A/archive/~A.tar.gz" base branch)
+        (multiple-value-bind (body res)
+            (dex:get (format nil "https://api.github.com/repos/~A/releases" base)
+                     :headers '(("X-GitHub-Api-Version" . "2022-11-28")))
+          (when (= res 200)
+            (getf  (first (jojo:parse body)) :|tarball_url|))))))
+
+(defun fetch-upstream (&optional (output *pwd*))
+  (let* ((url (get-newest-url "roswell/roswell"))
+         (path (make-pathname :name (format nil "roswell_~A.tar" (subseq url (1+ (position #\/ url :from-end t))))
+                              :defaults output
+                              :type "gz")))
+    (roswell.util:download url path)
+    path))
+
+(defun rename-upstream (path &optional (package-name *package-name*) (output *pwd*))
+  (let* ((name (pathname-name path))
+         (version% (aref (nth-value 1 (cl-ppcre:scan-to-strings
+                                       "\\((.*)-[0-9]*\\)"
+                                       (uiop/run-program:run-program
+                                        (format nil "cat ~A../ChangeLog|grep ^roswell| head -n 1" *pwd*) :output :string))) 0))
+         (version (if (equal version% "master-changelog-which-not-yet-released")
+                      *stab-version*
+                      version%))
+         (new (make-pathname :name (format nil "~A_~A.orig.tar" package-name
+                                           (subseq version 0
+                                                   (position #\- version)))
+                             :defaults output)))
+    (when (probe-file new)
+      (delete-file new))
+    (uiop/os:chdir output)
+    (uiop/run-program:run-program (format nil "tar xf ~A" (namestring path)))
+    (rename-file path new)
+    new))
+
+(defun cp-debian (output)
+  (let ((path (namestring
+               (first ;; should be sort.
+                (remove-if-not 
+                 #'(lambda (x)
+                     (and (not (pathname-name x))
+                          (string-equal "roswell" 
+                                        (first (last (pathname-directory x)))
+                                        :end2 (min 7 (length (first (last 
+                                                                     (pathname-directory x))))))))
+                 (directory (merge-pathnames "*.*" output)))))))
+    (uiop/run-program:run-program
+     (format nil "cat ~A../ChangeLog|sed -e s/master-changelog-which-not-yet-released/~A/>~Adebian/changelog" *pwd* *stab-version* path))
+    path))
+
+(defun dpkg-buildpackage (path)
+  (uiop/os:chdir path)
+  (uiop/run-program:run-program "dpkg-buildpackage -us -uc" :output :interactive))
+
+(defun main (&optional (arg0 "all") &rest argv)
+  (declare (ignorable argv arg0))
+  (let ((output (ensure-directories-exist (merge-pathnames "debian/" *pwd*))))
+    (cond ((equal arg0 "all")
+           (let* ((upstream (fetch-upstream output)))
+             (rename-upstream upstream "roswell" output))
+           (dpkg-buildpackage (cp-debian output)))
+          ((equal arg0 "clean")
+           (format *error-output* "hoge~%")))))

debian/files

@@ -1 +0,0 @@
-roswell_0.0.2.22-1_amd64.deb lisp optional

debian/init.d.ex

@@ -1,166 +0,0 @@
-#!/bin/sh
-### BEGIN INIT INFO
-# Provides:          roswell
-# Required-Start:    $local_fs $network $remote_fs $syslog
-# Required-Stop:     $local_fs $network $remote_fs $syslog
-# Default-Start:     2 3 4 5
-# Default-Stop:      0 1 6
-# Short-Description: <Enter a short description of the software>
-# Description:       <Enter a long description of the software>
-#                    <...>
-#                    <...>
-### END INIT INFO
-
-# Author: Masatoshi SANO <snmsts@gmail.com>
-
-# Do NOT "set -e"
-
-# PATH should only include /usr/* if it runs after the mountnfs.sh script
-PATH=/sbin:/usr/sbin:/bin:/usr/bin
-DESC="roswell"
-NAME=roswell
-DAEMON=/usr/sbin/roswell
-DAEMON_ARGS=""
-PIDFILE=/var/run/$NAME.pid
-SCRIPTNAME=/etc/init.d/$NAME
-
-# Exit if the package is not installed
-[ -x "$DAEMON" ] || exit 0
-
-# Read configuration variable file if it is present
-[ -r /etc/default/$NAME ] && . /etc/default/$NAME
-
-# Load the VERBOSE setting and other rcS variables
-. /lib/init/vars.sh
-
-# Define LSB log_* functions.
-# Depend on lsb-base (>= 3.2-14) to ensure that this file is present
-# and status_of_proc is working.
-. /lib/lsb/init-functions
-
-#
-# Function that starts the daemon/service
-#
-do_start()
-{
-	# Return
-	#   0 if daemon has been started
-	#   1 if daemon was already running
-	#   2 if daemon could not be started
-	start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON --test > /dev/null \
-		|| return 1
-	start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON -- \
-		$DAEMON_ARGS \
-		|| return 2
-	# The above code will not work for interpreted scripts, use the next
-	# six lines below instead (Ref: #643337, start-stop-daemon(8) )
-	#start-stop-daemon --start --quiet --pidfile $PIDFILE --startas $DAEMON \
-	#	--name $NAME --test > /dev/null \
-	#	|| return 1
-	#start-stop-daemon --start --quiet --pidfile $PIDFILE --startas $DAEMON \
-	#	--name $NAME -- $DAEMON_ARGS \
-	#	|| return 2
-
-	# Add code here, if necessary, that waits for the process to be ready
-	# to handle requests from services started subsequently which depend
-	# on this one.  As a last resort, sleep for some time.
-}
-
-#
-# Function that stops the daemon/service
-#
-do_stop()
-{
-	# Return
-	#   0 if daemon has been stopped
-	#   1 if daemon was already stopped
-	#   2 if daemon could not be stopped
-	#   other if a failure occurred
-	start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile $PIDFILE --name $NAME
-	RETVAL="$?"
-	[ "$RETVAL" = 2 ] && return 2
-	# Wait for children to finish too if this is a daemon that forks
-	# and if the daemon is only ever run from this initscript.
-	# If the above conditions are not satisfied then add some other code
-	# that waits for the process to drop all resources that could be
-	# needed by services started subsequently.  A last resort is to
-	# sleep for some time.
-	start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON
-	[ "$?" = 2 ] && return 2
-	# Many daemons don't delete their pidfiles when they exit.
-	rm -f $PIDFILE
-	return "$RETVAL"
-}
-
-#
-# Function that sends a SIGHUP to the daemon/service
-#
-do_reload() {
-	#
-	# If the daemon can reload its configuration without
-	# restarting (for example, when it is sent a SIGHUP),
-	# then implement that here.
-	#
-	start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name $NAME
-	return 0
-}
-
-case "$1" in
-  start)
-	[ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
-	do_start
-	case "$?" in
-		0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
-		2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
-	esac
-	;;
-  stop)
-	[ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
-	do_stop
-	case "$?" in
-		0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
-		2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
-	esac
-	;;
-  status)
-	status_of_proc "$DAEMON" "$NAME" && exit 0 || exit $?
-	;;
-  #reload|force-reload)
-	#
-	# If do_reload() is not implemented then leave this commented out
-	# and leave 'force-reload' as an alias for 'restart'.
-	#
-	#log_daemon_msg "Reloading $DESC" "$NAME"
-	#do_reload
-	#log_end_msg $?
-	#;;
-  restart|force-reload)
-	#
-	# If the "reload" option is implemented then remove the
-	# 'force-reload' alias
-	#
-	log_daemon_msg "Restarting $DESC" "$NAME"
-	do_stop
-	case "$?" in
-	  0|1)
-		do_start
-		case "$?" in
-			0) log_end_msg 0 ;;
-			1) log_end_msg 1 ;; # Old process is still running
-			*) log_end_msg 1 ;; # Failed to start
-		esac
-		;;
-	  *)
-		# Failed to stop
-		log_end_msg 1
-		;;
-	esac
-	;;
-  *)
-	#echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
-	echo "Usage: $SCRIPTNAME {start|stop|status|restart|force-reload}" >&2
-	exit 3
-	;;
-esac
-
-:

debian/manpage.1.ex

@@ -1,56 +0,0 @@
-.\"                                      Hey, EMACS: -*- nroff -*-
-.\" (C) Copyright 2015 Masatoshi SANO <snmsts@gmail.com>,
-.\"
-.\" First parameter, NAME, should be all caps
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
-.\" other parameters are allowed: see man(7), man(1)
-.TH ROSWELL SECTION "February  5, 2015"
-.\" Please adjust this date whenever revising the manpage.
-.\"
-.\" Some roff macros, for reference:
-.\" .nh        disable hyphenation
-.\" .hy        enable hyphenation
-.\" .ad l      left justify
-.\" .ad b      justify to both left and right margins
-.\" .nf        disable filling
-.\" .fi        enable filling
-.\" .br        insert line break
-.\" .sp <n>    insert n+1 empty lines
-.\" for manpage-specific macros, see man(7)
-.SH NAME
-roswell \- program to do something
-.SH SYNOPSIS
-.B roswell
-.RI [ options ] " files" ...
-.br
-.B bar
-.RI [ options ] " files" ...
-.SH DESCRIPTION
-This manual page documents briefly the
-.B roswell
-and
-.B bar
-commands.
-.PP
-.\" TeX users may be more comfortable with the \fB<whatever>\fP and
-.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
-.\" respectively.
-\fBroswell\fP is a program that...
-.SH OPTIONS
-These programs follow the usual GNU command line syntax, with long
-options starting with two dashes (`-').
-A summary of options is included below.
-For a complete description, see the Info files.
-.TP
-.B \-h, \-\-help
-Show summary of options.
-.TP
-.B \-v, \-\-version
-Show version of program.
-.SH SEE ALSO
-.BR bar (1),
-.BR baz (1).
-.br
-The programs are documented fully by
-.IR "The Rise and Fall of a Fooish Bar" ,
-available via the Info system.

debian/menu.ex

@@ -1,2 +0,0 @@
-?package(roswell):needs="X11|text|vc|wm" section="Applications/see-menu-manual"\
-  title="roswell" command="/usr/bin/roswell"

debian/postinst.ex

@@ -1,39 +0,0 @@
-#!/bin/sh
-# postinst script for roswell
-#
-# see: dh_installdeb(1)
-
-set -e
-
-# summary of how this script can be called:
-#        * <postinst> `configure' <most-recently-configured-version>
-#        * <old-postinst> `abort-upgrade' <new version>
-#        * <conflictor's-postinst> `abort-remove' `in-favour' <package>
-#          <new-version>
-#        * <postinst> `abort-remove'
-#        * <deconfigured's-postinst> `abort-deconfigure' `in-favour'
-#          <failed-install-package> <version> `removing'
-#          <conflicting-package> <version>
-# for details, see http://www.debian.org/doc/debian-policy/ or
-# the debian-policy package
-
-
-case "$1" in
-    configure)
-    ;;
-
-    abort-upgrade|abort-remove|abort-deconfigure)
-    ;;
-
-    *)
-        echo "postinst called with unknown argument \`$1'" >&2
-        exit 1
-    ;;
-esac
-
-# dh_installdeb will replace this with shell code automatically
-# generated by other debhelper scripts.
-
-#DEBHELPER#
-
-exit 0

debian/postrm.ex

@@ -1,37 +0,0 @@
-#!/bin/sh
-# postrm script for roswell
-#
-# see: dh_installdeb(1)
-
-set -e
-
-# summary of how this script can be called:
-#        * <postrm> `remove'
-#        * <postrm> `purge'
-#        * <old-postrm> `upgrade' <new-version>
-#        * <new-postrm> `failed-upgrade' <old-version>
-#        * <new-postrm> `abort-install'
-#        * <new-postrm> `abort-install' <old-version>
-#        * <new-postrm> `abort-upgrade' <old-version>
-#        * <disappearer's-postrm> `disappear' <overwriter>
-#          <overwriter-version>
-# for details, see http://www.debian.org/doc/debian-policy/ or
-# the debian-policy package
-
-
-case "$1" in
-    purge|remove|upgrade|failed-upgrade|abort-install|abort-upgrade|disappear)
-    ;;
-
-    *)
-        echo "postrm called with unknown argument \`$1'" >&2
-        exit 1
-    ;;
-esac
-
-# dh_installdeb will replace this with shell code automatically
-# generated by other debhelper scripts.
-
-#DEBHELPER#
-
-exit 0

debian/preinst.ex

@@ -1,35 +0,0 @@
-#!/bin/sh
-# preinst script for roswell
-#
-# see: dh_installdeb(1)
-
-set -e
-
-# summary of how this script can be called:
-#        * <new-preinst> `install'
-#        * <new-preinst> `install' <old-version>
-#        * <new-preinst> `upgrade' <old-version>
-#        * <old-preinst> `abort-upgrade' <new-version>
-# for details, see http://www.debian.org/doc/debian-policy/ or
-# the debian-policy package
-
-
-case "$1" in
-    install|upgrade)
-    ;;
-
-    abort-upgrade)
-    ;;
-
-    *)
-        echo "preinst called with unknown argument \`$1'" >&2
-        exit 1
-    ;;
-esac
-
-# dh_installdeb will replace this with shell code automatically
-# generated by other debhelper scripts.
-
-#DEBHELPER#
-
-exit 0

debian/prerm.ex

@@ -1,38 +0,0 @@
-#!/bin/sh
-# prerm script for roswell
-#
-# see: dh_installdeb(1)
-
-set -e
-
-# summary of how this script can be called:
-#        * <prerm> `remove'
-#        * <old-prerm> `upgrade' <new-version>
-#        * <new-prerm> `failed-upgrade' <old-version>
-#        * <conflictor's-prerm> `remove' `in-favour' <package> <new-version>
-#        * <deconfigured's-prerm> `deconfigure' `in-favour'
-#          <package-being-installed> <version> `removing'
-#          <conflicting-package> <version>
-# for details, see http://www.debian.org/doc/debian-policy/ or
-# the debian-policy package
-
-
-case "$1" in
-    remove|upgrade|deconfigure)
-    ;;
-
-    failed-upgrade)
-    ;;
-
-    *)
-        echo "prerm called with unknown argument \`$1'" >&2
-        exit 1
-    ;;
-esac
-
-# dh_installdeb will replace this with shell code automatically
-# generated by other debhelper scripts.
-
-#DEBHELPER#
-
-exit 0

debian/roswell.cron.d.ex

@@ -1,4 +0,0 @@
-#
-# Regular cron jobs for the roswell package
-#
-0 4	* * *	root	[ -x /usr/bin/roswell_maintenance ] && /usr/bin/roswell_maintenance

debian/roswell.debhelper.log

@@ -1,21 +0,0 @@
-override_dh_autoreconf dh_autoreconf
-dh_autoreconf
-dh_auto_configure
-dh_auto_build
-dh_auto_test
-dh_prep
-dh_auto_install
-dh_installdocs
-dh_installchangelogs
-dh_perl
-dh_link
-dh_compress
-dh_fixperms
-dh_strip
-dh_makeshlibs
-dh_shlibdeps
-dh_installdeb
-dh_gencontrol
-dh_md5sums
-dh_builddeb
-dh_builddeb

debian/roswell.default.ex

@@ -1,10 +0,0 @@
-# Defaults for roswell initscript
-# sourced by /etc/init.d/roswell
-# installed at /etc/default/roswell by the maintainer scripts
-
-#
-# This is a POSIX shell fragment
-#
-
-# Additional options that are passed to the Daemon.
-DAEMON_OPTS=""

debian/roswell.doc-base.EX

@@ -1,20 +0,0 @@
-Document: roswell
-Title: Debian roswell Manual
-Author: <insert document author here>
-Abstract: This manual describes what roswell is
- and how it can be used to
- manage online manuals on Debian systems.
-Section: unknown
-
-Format: debiandoc-sgml
-Files: /usr/share/doc/roswell/roswell.sgml.gz
-
-Format: postscript
-Files: /usr/share/doc/roswell/roswell.ps.gz
-
-Format: text
-Files: /usr/share/doc/roswell/roswell.text.gz
-
-Format: HTML
-Index: /usr/share/doc/roswell/html/index.html
-Files: /usr/share/doc/roswell/html/*.html

debian/rules

@@ -12,4 +12,4 @@ override_dh_autoreconf:
 	dh_autoreconf
 
 %:
-	dh "$@" --with=autoreconf 
+	dh $@ --with autoreconf,bash-completion

debian/watch.ex

@@ -1,23 +0,0 @@
-# Example watch control file for uscan
-# Rename this file to "watch" and then you can run the "uscan" command
-# to check for upstream updates and more.
-# See uscan(1) for format
-
-# Compulsory line, this is a version 3 file
-version=3
-
-# Uncomment to examine a Webpage
-# <Webpage URL> <string match>
-#http://www.example.com/downloads.php roswell-(.*)\.tar\.gz
-
-# Uncomment to examine a Webserver directory
-#http://www.example.com/pub/roswell-(.*)\.tar\.gz
-
-# Uncommment to examine a FTP server
-#ftp://ftp.example.com/pub/roswell-(.*)\.tar\.gz debian uupdate
-
-# Uncomment to find new files on sourceforge, for devscripts >= 2.9
-# http://sf.net/roswell/roswell-(.*)\.tar\.gz
-
-# Uncomment to find new files on GooglePages
-# http://example.googlepages.com/foo.html roswell-(.*)\.tar\.gz

documents/Makefile.am

@@ -0,0 +1,44 @@
+# TODO : fetch from https://github.com/roswell/roswell/wiki and convert all
+# wiki pages (mediawiki format or markdown) to html or man
+
+# see also:
+# http://pandoc.org/README.html#using-variables-in-templates
+# https://github.com/jgm/pandoc-templates/blob/master/default.man
+
+# separated by semicolons
+PANDOC_AUTHORS="Roswell Project Team"
+CLEANFILES=roswell.chm
+
+if MANUAL_GENERATE
+MDS = $(wildcard *.md)
+man1_MANS = $(MDS:%.md=man/%.1)
+
+man/%.1: %.md
+	which pandoc
+	pandoc -f markdown -t man -V title="$*" -V section=$(subst .,,$(suffix $@)) \
+	-V author=$(PANDOC_AUTHORS) --template=default.man $<  > $@
+CLEANFILES+=$(man1_MANS)
+endif
+
+if HTML_GENERATE
+HTMLS = $(MDS:%.md=html/%.html)
+html/%.html: %.md
+	which pandoc
+# awk hack --- check every underlined words for its corresponding md file, replacing it to an appropriate markdown link to html file if it exist (e.g. _ros-use_ -> check ros-use.md -> [ros-use](ros-use.html) )
+# special care should be made regarding checking the existence of the file; 
+	awk 'BEGIN{RS="_"; ORS="_"} {target=$$0;gsub("`","",target);if(system("[ -e \""target".md\" ]") == 0){print "["$$1"]("$$1".html)"}else{print $$0}}' < $< | \
+	pandoc -f markdown -t html5 -V title="$*(1)" -V pagetitle="$*(1)" \
+	-V css=../ros.css -V author=$(PANDOC_AUTHORS) --template=default.html > $@
+
+# html/%.css: %.scss
+# 	which scss
+# 	scss $< $@
+CLEANFILES+=$(HTMLS)
+endif
+
+all: $(man1_MANS) $(HTMLS)
+
+roswell.chm: $(HTMLS)
+	ros ./chm.ros
+	/c/Program\ Files\ \(x86\)/HTML\ Help\ Workshop/hhc.exe ./roswell.hhp ||true
+	$(RM) roswell.hhp roswell.hhk roswell.hhc

documents/chm.ros

@@ -0,0 +1,105 @@
+#!/bin/sh
+#|-*- mode:lisp -*-|#
+#|
+exec ros -Q -- $0 "$@"
+|#
+(defvar *current-path* (make-pathname :defaults *load-pathname*
+				      :name nil :type nil))
+
+(defun hhp ()
+  (with-open-file (o (ensure-directories-exist
+                      (merge-pathnames "roswell.hhp" *current-path*))
+                     :direction :output
+                     :if-exists :supersede
+                     :if-does-not-exist :create)
+    (format o (format nil "~~{~~A~A~A~~}" #\Return #\Newline)
+            '("[OPTIONS]"
+              "Compatibility=1.1 or later"
+              "Compiled file=roswell.chm"
+              "Contents file=roswell.hhc"
+              "Default topic=html\\ros.html"
+              "Display compile progress=No"
+              "Index file=roswell.hhk"
+              "Language=0x411 Japanese (Japan)"
+              ""
+              ""
+              "[FILES]"))
+    (loop for f in (directory
+                    (merge-pathnames "html/*.html"
+                                     *current-path*))
+       do (format o "html\\~A~A~A"
+                  (file-namestring f)
+                  #\Return #\Newline))
+    (format o (format nil "~~{~~A~A~A~~}" #\Return #\Newline)
+            '(""
+              "[INFOTYPES]"
+              ""))))
+
+(defun hhk ()
+  (with-open-file (o (ensure-directories-exist
+                      (merge-pathnames "roswell.hhk" *current-path*))
+                     :direction :output
+                     :if-exists :supersede
+                     :if-does-not-exist :create)
+    (format o (format nil "~~{~~A~A~A~~}" #\Return #\Newline)
+            '("<!DOCTYPE HTML PUBLIC \"-//IETF//DTD HTML//EN\">"
+              "<HTML>"
+              "<HEAD>"
+              "<meta name=\"GENERATOR\" content=\"Microsoft&reg; HTML Help Workshop 4.1\">"
+              "<!-- Sitemap 1.0 -->"
+              "</HEAD><BODY>"
+              "<UL>"))
+    (loop for f in (directory
+                    (merge-pathnames "html/*.html"
+                                     *current-path*))
+       do (format o (format nil "~~{~~A~A~A~~}" #\Return #\Newline)
+                  `("<LI> <OBJECT type=\"text/sitemap\">"
+                    ,(format nil "<param name=\"Name\" value=\"~A\">" (pathname-name f))
+                    ,(format nil "<param name=\"Name\" value=\"~A(1)\">" (pathname-name f))
+                    ,(format nil "<param name=\"Local\" value=\"html\\~A\">" (file-namestring f))
+                    "</OBJECT>")))
+    (format o (format nil "~~{~~A~A~A~~}" #\Return #\Newline)
+            '(""
+              "</UL>"
+              "</BODY></HTML>"))))
+
+(defun hhc ()
+  (with-open-file (o (ensure-directories-exist
+                      (merge-pathnames "roswell.hhc" *current-path*))
+                     :direction :output
+                     :if-exists :supersede
+                     :if-does-not-exist :create)
+    (format o (format nil "~~{~~A~A~A~~}" #\Return #\Newline)
+            '("<!DOCTYPE HTML PUBLIC \"-//IETF//DTD HTML//EN\">"
+              "<HTML>"
+              "<HEAD>"
+              "<meta name=\"GENERATOR\" content=\"Microsoft&reg; HTML Help Workshop 4.1\">"
+              "<!-- Sitemap 1.0 -->"
+              "</HEAD><BODY>"
+              "<OBJECT type=\"text/site properties\">"
+              "<param name=\"ImageType\" value=\"Folder\">"
+              "</OBJECT>"
+              "<UL>"
+              "<LI> <OBJECT type=\"text/sitemap\">"
+              "<param name=\"Name\" value=\"man\">"
+              "</OBJECT>"
+              "<UL>"))
+    (loop for f in (directory
+                    (merge-pathnames "html/*.html"
+                                     *current-path*))
+       do (format o (format nil "~~{~~A~A~A~~}" #\Return #\Newline)
+                  `("<LI> <OBJECT type=\"text/sitemap\">"
+                    ,(format nil "<param name=\"Name\" value=\"~A\">" (pathname-name f))
+                    ,(format nil "<param name=\"Local\" value=\"html\\~A\">" (file-namestring f))
+                    "</OBJECT>")))
+    (format o (format nil "~~{~~A~A~A~~}" #\Return #\Newline)
+            '(""
+              "</UL>"
+              "</UL>"
+              "</BODY></HTML>"))))
+
+(defun main (&rest argv)
+  (declare (ignorable argv))
+  (hhp)
+  (hhk)
+  (hhc))

documents/default.html

@@ -0,0 +1,69 @@
+<!DOCTYPE html>
+<html$if(lang)$ lang="$lang$"$endif$$if(dir)$ dir="$dir$"$endif$>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+$for(author-meta)$
+  <meta name="author" content="$author-meta$">
+$endfor$
+$if(date-meta)$
+  <meta name="dcterms.date" content="$date-meta$">
+$endif$
+$if(keywords)$
+  <meta name="keywords" content="$for(keywords)$$keywords$$sep$, $endfor$">
+$endif$
+  <title>$if(title-prefix)$$title-prefix$ – $endif$$pagetitle$</title>
+  <style type="text/css">code{white-space: pre;}</style>
+$if(quotes)$
+  <style type="text/css">q { quotes: "“" "”" "‘" "’"; }</style>
+$endif$
+$if(highlighting-css)$
+  <style type="text/css">
+$highlighting-css$
+  </style>
+$endif$
+$for(css)$
+  <link rel="stylesheet" href="$css$">
+$endfor$
+$if(math)$
+  $math$
+$endif$
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+$for(header-includes)$
+  $header-includes$
+$endfor$
+</head>
+<body>
+$for(include-before)$
+$include-before$
+$endfor$
+$if(title)$
+<header>
+<h1 class="title">$title$</h1>
+$if(subtitle)$
+<h1 class="subtitle">$subtitle$</h1>
+$endif$
+<ul>
+$for(author)$
+<li class="author">$author$</li>
+$endfor$
+</ul>
+$if(date)$
+<h3 class="date">$date$</h3>
+$endif$
+</header>
+$endif$
+$if(toc)$
+<nav id="$idprefix$TOC">
+$toc$
+</nav>
+$endif$
+$body$
+$for(include-after)$
+$include-after$
+$endfor$
+</body>
+</html>

documents/default.man

@@ -0,0 +1,30 @@
+$if(has-tables)$
+.\"t
+$endif$
+$if(pandoc-version)$
+.\" Automatically generated by Pandoc $pandoc-version$
+.\"
+$endif$
+$if(adjusting)$
+.ad $adjusting$
+$endif$
+.TH "$title$" "$section$" "$date$" "$footer$" "$header$"
+$if(hyphenate)$
+.hy
+$else$
+.nh \" Turn off hyphenation by default.
+$endif$
+$for(header-includes)$
+$header-includes$
+$endfor$
+$for(include-before)$
+$include-before$
+$endfor$
+$body$
+$for(include-after)$
+$include-after$
+$endfor$
+$if(author)$
+.SH AUTHORS
+$for(author)$$author$$sep$; $endfor$.
+$endif$

documents/html/ros-asdf.html

@@ -0,0 +1,38 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <meta name="author" content="Roswell Project Team">
+  <title>ros-asdf(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-asdf(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+<h3 class="date">January 2022</h3>
+</header>
+<h1 id="name">NAME</h1>
+<p>ros-asdf -</p>
+<h1 id="synopsis">SYNOPSIS</h1>
+<p><strong>ros [options] asdf [subcommand]</strong></p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!--   : description. end with a period. -->
+<h1 id="description">DESCRIPTION</h1>
+<p><strong>ros asdf</strong> install and manage ASDF(https://common-lisp.net/project/asdf/).</p>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-build.html

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-build(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-build(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-build - Shortcut to “ros dump executable” # synopsis</p>
+<p><strong>ros [options] build</strong> <file></p>
+<p>Equivalent to calling <code>ros dump executable &lt;file&gt;</code>.</p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!--   : description. end with a period. -->
+<h1 id="description">description</h1>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-checkout.html

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-checkout(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-checkout(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-checkout - # synopsis</p>
+<p><strong>ros [options] checkout</strong> args…</p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!--   : description. end with a period. -->
+<h1 id="description">description</h1>
+<p>to enable this command ros install roswell/ql-checkout is needed.</p>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-client.html

@@ -0,0 +1,47 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-client(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-client(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-client - one-shot connect to remote repl.</p>
+<h1 id="synopsis">synopsis</h1>
+<p><strong>ros client</strong> protocol [options for the protocol …] …</p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!--   : description. end with a period. -->
+<h1 id="description">description</h1>
+<p><code>ros-client</code> send message to lisp server and wait for message sent back.</p>
+<h1 id="swank-protocol-options">swank protocol options</h1>
+<dl>
+<dt><code>--port port</code></dt>
+<dd><p>set server <code>port</code> to connect. default port 4005.</p>
+</dd>
+<dt><code>--interface interface</code></dt>
+<dd><p>interface for connect. default is <code>localhost</code>.</p>
+</dd>
+<dt>-e FORM –eval FORM</dt>
+<dd><p>Evaluate FORM while building</p>
+</dd>
+</dl>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1) <em><a href="ros-serve.html">ros-serve</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-config.html

@@ -0,0 +1,39 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-config(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-config(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-config - get and set options # Synopsis</p>
+<p><strong>ros [options] config</strong> [SUBCOMMAND ARGS…]</p>
+<h1 id="description">Description</h1>
+<p>Without any arguments, it shows all variables and it’s value.</p>
+<dl>
+<dt>show TARGET</dt>
+<dd><p>show TARGET.</p>
+</dd>
+<dt>set TARGET VALUE</dt>
+<dd><p>set the VALUE to the TARGET.</p>
+</dd>
+</dl>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-delete.html

@@ -0,0 +1,40 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-delete(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-delete(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-delete - # synopsis</p>
+<p><strong>ros delete</strong> ARGS…</p>
+<p>Slightly complex arguments.</p>
+<h2 id="ros-delete-dump-images">ros delete dump IMAGES…</h2>
+<p>Whem ARGS starts with <code>dump</code>, it considers the remaining args as the names for the dumped images. It then deletes the image with the given name, if it exists.</p>
+<p>The deletion happens only to the images compatible with the current lisp implementation/version. For example, when ccl-bin/1.10 and sbcl-bin/1.3.1 both have images named X, and if the current lisp in use is sbcl-bin/1.3.1, then <code>ros delete dump X</code> removes sbcl-bin/1.3.1/X only.</p>
+<h2 id="ros-delete-impls">ros delete IMPLS…</h2>
+<p>When the first argument is not <code>dump</code>, then the arguments are treated as a list of installed implementations.</p>
+<p>If a name of some implementation is given without version specifiers, e.g. sbcl-bin, then it removes all instances (versions) of sbcl-bin.</p>
+<p>If a version is specified, then it removes only the specified instance.</p>
+<!-- somecommand -->
+<!--   : description. end with a period. -->
+<h1 id="description">description</h1>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-dist.html

@@ -0,0 +1,33 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-dist(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-dist(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-dist - # synopsis</p>
+<p><strong>ros [options] dist</strong> args…</p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!--   : description. end with a period. -->
+<h1 id="description">description</h1>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-dump.html

@@ -0,0 +1,95 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-dump(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-dump(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-dump - make a dumped image of a roswell script</p>
+<h1 id="synopsis">Synopsis</h1>
+<p><strong>ros [OPTIONS1…] dump [OPTIONS2…] MODE</strong> args…</p>
+<p><code>OPTIONS1</code> specify the standard roswell options such as <code>-L</code> or <code>-m LISP</code>. <code>OPTIONS2</code> specify the image reduction options we describe later. <code>MODE</code> is either <code>output</code> or <code>executable</code>.</p>
+<h1 id="description">Description</h1>
+<p><code>ros-dump</code> creates a dumped lisp image of the state after processing all options <code>OPTIONS1</code>.</p>
+<p>It has two modes <code>output</code> and <code>executable</code>. In both modes, the global environment (e.g. global binding to special variables such as <code>*package*</code>) of the state just after the restart is the environment which was effective when the script was dumped.</p>
+<!-- Fixme: what kind of? this is unnecessarily retracting the users from using this feature -->
+<!-- There might be a limitation regarding this feature depending on the lisp -->
+<!-- implementation used by roswell at the time of building.   -->
+<p>The dumped image is generally not compatible between the different implementations, and also between the versions.</p>
+<h1 id="dump-modes">Dump modes</h1>
+<h2 id="output--f--o-output-name">output [-f] [-o OUTPUT] NAME</h2>
+<p>It loads the roswell script <code>NAME</code> and saves the current lisp state to an image.</p>
+<p>The image file is by default written to an internal directory of roswell in an organized manner, i.e., somewhere under <code>$ROSWELL_INSTALL_DIR</code> deduced by the current implementation, its version and the given NAME.</p>
+<p>When the output file already exists, the command fails with an error code.</p>
+<p>The image can be loaded by <code>ros -m IMAGE</code>. When restarting from the image, standard roswell subcommands and additional arguments to the script are also available, for example <code>ros run</code> to resume with a repl, or <code>--restart FUNC</code> to call a specific function, leaving some flexibility.</p>
+<dl>
+<dt><code>-o OUTPUT</code></dt>
+<dd><p>The image is written to <code>OUTPUT</code> instead of the default location.</p>
+</dd>
+<dt><code>-f</code></dt>
+<dd><p>Force output when the output already exists.</p>
+</dd>
+</dl>
+<h2 id="executable-name--o-output">executable NAME [-o OUTPUT]</h2>
+<p>When a script is dumped with <code>executable</code>, the dumped image becomes an self-contained executable binary which implies <code>--restart main</code>.</p>
+<p>If <code>OUTPUT</code> is given, the resulting binary is written to this file. Otherwise, the output filename is deduced from <code>NAME</code> and is written in the same directory. On Windows and if <code>SCRIPT</code> has <code>.ros</code> extension, the filename will be <code>SCRIPT.exe</code>. On the other systems, the result will be <code>SCRIPT</code> (without extension).</p>
+<p>This feature is supported on SBCL, CCL, CMUCL, CLISP, ECL.</p>
+<h1 id="image-reduction-options">Image Reduction Options</h1>
+<p>These options unlink some references to the runtime objects and allow gcs to reclaim some memory, which eventually reduces the size of the dumped image.</p>
+<p>Care should be taken to ensure the resulting program works as expected, as some of these operation may destroy the common assumptions of the conforming programs. For example, package-related reduction options may inhibit the runtime calls to <code>READ</code> after the restart.</p>
+<p>Reduction options are processed in the left-to-right manner.</p>
+<dl>
+<dt>–disable-compression, –enable-compression, -c</dt>
+<dd><p>These options disable/enable/enable the core compression feature in SBCL. Thus this option is meaningful only on SBCL. Compression is enabled by default.</p>
+</dd>
+<dt>–remove-docstrings</dt>
+<dd><p>This option removes all docstrings from all symbols in the entire lisp image.</p>
+</dd>
+<dt>–delete-package PKG</dt>
+<dd><p>This option can be specified multiple times. It uninterns the symbols in PACKAGE, calls <code>makeunbound</code> and <code>fmakeunbound</code> on each symbol and deletes the package. Package names are automatically string-upcase’d.</p>
+</dd>
+<dt>–delete-all-packages</dt>
+<dd><p>This option applies –delete-package PKG on all packages, except some blacklisted packages (keyword, roswell, ROS.SCRIPT.DUMP, and the package of the main function symbol).</p>
+</dd>
+<dt>–delete-packages-except PACKAGE</dt>
+<dd><p>This option can be specified multiple times. It is identical to –delete-all-packages except that it adds PACKAGE to the blacklist. Package names are automatically string-upcase’d.</p>
+</dd>
+<dt>–destroy-packages-sbcl</dt>
+<dd><p>This is an sbcl-specific option which is even more aggressive than the above methods (&gt;10MB reduction). It destroys the package system by modifying the internal tables for packages, cleaning up the caches for package-use-list etc. The blacklist is shared among –delete-all-packages and –destroy-packages-sbcl. However, this method does not call fmakunbound/makunbound, so combining the two methods can result in a more aggressive image size reduction. Due to the nature of this option, it is desirable to specify it as the last method (i.e. rightmost).</p>
+</dd>
+<dt>–purify, –no-purify</dt>
+<dd><p>This is common to CCL, SBCL, CMUCL. Moves all objects to the static space where GC does not scan, for the later performance of GC. Purification is enabled by default.</p>
+</dd>
+<dt>–impurify, –no-impurify</dt>
+<dd><p>This is an CCL-specific option (enabled by default). It moves all objects to the dynamic space before saving the image. This allows the static-space objects to be GC’ed. When purification is enabled, it impurifies all objects before running the purifying GC.</p>
+</dd>
+<dt>–delete-debug-info</dt>
+<dd><p>This removes the debug infomation of functions (used to show the stack frame etc), as well as the source locations and the deprecation information of various symbols. SBCL only. This option has a large effect (+10MB reduction).</p>
+</dd>
+<dt>–delete-macro-definitions, –delete-compiler-macro-definitions</dt>
+<dd><p>This removes all definitions of macros and compiler-macros, assuming that no runtime compilation/interpretation of code will be performed. This option should be portable across implementations. It has ~2MB reduction on SBCL.</p>
+</dd>
+<dt>–delete-compiler-information-sbcl</dt>
+<dd><p>This is an SBCL-specific option which is more aggressive than the above methods (~4MB reduction). In addition to the macro and the compiler-macro definitions, it destroys the internal compiler systems of SBCL by also removing the inlining information, IR1 transformer and IR2 (VOP).</p>
+</dd>
+</dl>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em>sbcl</em>(1) <em><a href="ros.html">ros</a></em>(1) <em><a href="ros-init.html">ros-init</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-emacs.html

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-emacs(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-emacs(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-emacs - launch Emacs with Slime # Synopsis</p>
+<p><strong>ros emacs</strong> [ARGS…]</p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!--   : description. end with a period. -->
+<h1 id="description">Description</h1>
+<p>Launches Emacs with a Slime(https://common-lisp.net/project/slime/) buffer opened, which is connected to the back-end lisp implementation of roswell. Additional arguments are passed to emacs.</p>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1), <em>emacs</em>(1) _</p>
+</body>
+</html>

documents/html/ros-help.html

@@ -0,0 +1,36 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-help(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-help(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-help - Show Command help</p>
+<h1 id="synopsis">Synopsis</h1>
+<p><strong>ros help</strong> [subcommand or topics]</p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!-- :description. end with a period. -->
+<h1 id="description">Description</h1>
+<p><strong>ros help</strong> shows description of subcommand or topics</p>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em>sbcl</em>(1), <em><a href="ros.html">ros</a></em>(1)</p>
+<p>_</p>
+</body>
+</html>

documents/html/ros-init.html

@@ -0,0 +1,62 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-init(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-init(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-init - Create a roswell script (optionally based on a template)</p>
+<h1 id="synopsis">Synopsis</h1>
+<p><strong>ros init [TEMPLATE] NAME [ARGS…]]</strong></p>
+<dl>
+<dt>TEMPLATE</dt>
+<dd><p>Specifies the name of a template, defaulted to <em>default</em> template. However, if <em>TEMPLATE</em> is not specified and <em>FILENAME</em> matches one of the templates being stored, then it automatically uses the template. To suppress this behavior, you should explicitly specify <em>TEMPLATE</em> as <em>default</em>.</p>
+<p>Thus you are warned when you use this command from a shell script. In order to achieve a consistent and desired behavior, it is adviced that they should always explicitly specify the template name.</p>
+</dd>
+<dt>NAME</dt>
+<dd><p>Specify the output filename, or “-” to indicate <em>stdout</em>. When <em>TEMPLATE</em> is <em>default</em>, it automatically appends a file type “.ros”.</p>
+</dd>
+</dl>
+<!-- # subcommands -->
+<h1 id="description">Description</h1>
+<p>Initialises a roswell file based on a template. User-specified templates can be added by <em><a href="ros-template.html">ros-template</a></em>(1).</p>
+<p>The default template is something like:</p>
+<pre><code>#!/bin/sh
+#|-*- mode:lisp -*-|#
+#| &lt;Put a one-line description here&gt;
+exec ros -Q -- $0 &quot;$@&quot;
+|#
+(progn ;;init forms
+  (ros:ensure-asdf)
+  ;;#+quicklisp (ql:quickload &#39;() :silent t)
+  )
+
+(defpackage :ros.script.test.3703600390
+  (:use :cl))
+(in-package :ros.script.test.3703600390)
+
+(defun main (&amp;rest argv)
+  (declare (ignorable argv)))
+;;; vim: set ft=lisp lisp:</code></pre>
+<p>This is basically a shell script which immediately invokes Roswell by exec (see <em>sh(1)</em>). Roswell loads the same script as an input, skips multi-line comments, reads the rest of the file as a Common Lisp program, and finally invokes a function main with command-line arguments.</p>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em>sbcl</em>(1) <em><a href="ros.html">ros</a></em>(1) <em><a href="ros-template.html">ros-template</a></em>(1)</p>
+<p>_</p>
+</body>
+</html>

documents/html/ros-install.html

@@ -0,0 +1,80 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-install(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-install(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-install - Install lisp implementations or quicklisp system</p>
+<h1 id="synopsis">Synopsis</h1>
+<ul>
+<li><strong>ros install</strong> system [system …]</li>
+<li><strong>ros install</strong> impl[/version] [param …]</li>
+</ul>
+<h1 id="description">Description</h1>
+<dl>
+<dt>system</dt>
+<dd><p>a name specifying a system.</p>
+</dd>
+<dt>impl</dt>
+<dd><p>a name specifying a lisp implementation.</p>
+</dd>
+</dl>
+<!-- # subcommands -->
+<h1 id="installing-a-lisp-implementation">Installing a Lisp Implementation</h1>
+<p>When the <code>impl</code> or <code>system</code> matches to one of the supported implementations, it fetches, downloads and installs it to one of the internal directory managed by roswell (~/.roswell, or <code>ROSWELL_INSTALL_DIR</code>). In order to use the installed implementation, you have to run <em>ros-use(1)</em>.</p>
+<p>For example, the following command downloads the latest sbcl binary from sbcl.org. Note that this may be different from the default binary installed by roswell, called <code>sbcl-bin</code>. <code>sbcl-bin</code> is a stable and well-tested version of the sbcl binary which is supposed to be a little older than the latest sbcl.</p>
+<pre><code>$ ros install sbcl</code></pre>
+<p>When invoked without a name, it prints the list of installable implementations. (Not to be confused with <code>ros list installed</code>, which shows the implementations already installed.)</p>
+<pre><code>Usage: ros install impl [OPTIONS]
+
+For more details on impl specific options, type:
+ros help install impl
+
+Candidates impls for installation are:
+ecl
+sbcl
+clisp
+ccl-bin
+sbcl-bin</code></pre>
+<p>The name can be optionally followed by a slash <code>/</code> and a version of the implementation.</p>
+<pre><code>$ ros install sbcl/1.2.14</code></pre>
+<p>There might be some <em>hidden</em> implementation that are not listed here — they are in the alpha quality, but try the one you like or watch the website (https://github.com/roswell/roswell).</p>
+<pre><code>$ ros install ccl
+$ ros install abcl
+$ ...</code></pre>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="installing-a-quicklisp-system-and-the-bundled-roswell-scripts">Installing a quicklisp system and the bundled roswell scripts</h1>
+<p>If the specified name does not match any of the implementations, roswell tries to find a quicklisp system of the given name.</p>
+<pre><code>$ ros install alexandria</code></pre>
+<p>After compiling and loading the system, it funcalls <code>ros:*build-hook*</code> special variable with no argument, if some function is set during the compilation/load.</p>
+<p>When the system comes with a <strong>roswell script</strong> created by <em><a href="ros-init.html">ros-init</a></em>(1) in the subdirectory <code>roswell</code>, they are installed into <strong>ROSWELL_INSTALL_DIR/bin</strong>. Setting the path to this directory makes those scripts available from the shell command line.</p>
+<pre><code>$ ros install qlot
+System &#39;qlot&#39; found. Loading the system..
+Processing build-hook..
+Found 1 scripts: qlot
+Attempting to install the scripts in roswell/ subdirectory of the system...
+/home/user/.roswell/bin/qlot
+
+$ qlot
+Usage: qlot [install | update | bundle | exec shell-args..]</code></pre>
+<h1 id="see-also">SEE ALSO</h1>
+<p><em>sbcl</em>(1), <em><a href="ros.html">ros</a></em>(1), <em><a href="ros-list.html">ros-list</a></em>(1), <em><a href="ros-init.html">ros-init</a></em>(1)</p>
+<p>_</p>
+</body>
+</html>

documents/html/ros-list.html

@@ -0,0 +1,47 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-list(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-list(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-list - list the materials installed by roswell</p>
+<h1 id="synopsis">Synopsis</h1>
+<p><strong>ros list [type] [options]</strong></p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!-- :description. end with a period. -->
+<h1 id="description">Description</h1>
+<p><strong>ros list</strong> shows the list of the materials installed by roswell.</p>
+<dl>
+<dt>installed [ [ IMPL | IMPL/VERSION ]…]</dt>
+<dd><p>List the implementations that have been already installed. Optionally providing IMPL shows the installed versions of the implementation.</p>
+</dd>
+<dt>dump [IMPL]</dt>
+<dd><p>List the internal dumped images that are compatible with IMPL. When IMPL is ommited, it is defaulted to the current lisp implementation in use. Images are in <code>$ROSWELL_INSTALL_DIR/impl/.../dump/</code>.</p>
+</dd>
+<dt>versions [IMPL]</dt>
+<dd><p>List the installable versions for IMPL. When IMPL is ommited, it is defaulted to the current lisp implementation in use. This feature is experimental.</p>
+</dd>
+</dl>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em>sbcl</em>(1) <em><a href="ros.html">ros</a></em>(1)</p>
+<p>_</p>
+</body>
+</html>

documents/html/ros-run.html

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-run(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-run(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-run - start a REPL # Synopsis</p>
+<p><strong>ros [options] run</strong></p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!--   : description. end with a period. -->
+<h1 id="description">Description</h1>
+<p>Processes the given options and start a REPL using the currently effective lisp implementation set by <em><a href="ros-use.html">ros-use</a></em>(1).</p>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-serve.html

@@ -0,0 +1,44 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-serve(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-serve(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-serve - start lisp server</p>
+<h1 id="synopsis">Synopsis</h1>
+<p><strong>ros [options for roswell … ] serve</strong> protocol [options for the protocol …] …</p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!--   : description. end with a period. -->
+<h1 id="description">description</h1>
+<p><code>ros-serve</code> start lisp and wait for clients to connect to the lisp.</p>
+<h1 id="swank-protocol-options">swank protocol options</h1>
+<dl>
+<dt><code>--port port</code></dt>
+<dd><p>Listen port would be <code>port</code> instead of the default port 4005.</p>
+</dd>
+<dt><code>--interface interface</code></dt>
+<dd><p>limit interface for listen. default is <code>localhost</code> so there would be no limitation.</p>
+</dd>
+</dl>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1) <em><a href="ros-client.html">ros-client</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-setup.html

@@ -0,0 +1,42 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-setup(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-setup(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-setup - setup the backend of roswell</p>
+<h1 id="synopsis">Synopsis</h1>
+<p><strong>ros setup</strong></p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!-- :description. end with a period. -->
+<h1 id="description">Description</h1>
+<p><strong>ros setup</strong> initializes roswell. The process includes the following steps:</p>
+<ul>
+<li>Downloading the default stable lisp implementation (sbcl-bin) to <code>ROSWELL_INSTALL_DIR</code>.</li>
+<li>Installing quicklisp to <code>ROSWELL_INSTALL_DIR</code>.</li>
+<li>On Windows, install 7zip to <code>ROSWELL_INSTALL_DIR</code>.</li>
+<li>Making the core image of roswell itself.</li>
+</ul>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em>sbcl</em>(1), <em><a href="ros.html">ros</a></em>(1), section Environmental Variables</p>
+<p>_</p>
+</body>
+</html>

documents/html/ros-template.html

@@ -0,0 +1,151 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-template(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-template(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-template - Edit template for ros-init</p>
+<h1 id="synopsis">synopsis</h1>
+<ul>
+<li><strong>ros template</strong> command args…</li>
+</ul>
+<h1 id="subcommands">Subcommands</h1>
+<dl>
+<dt>init template-name</dt>
+<dd><p>Create new template in local-project directory.</p>
+</dd>
+<dt>deinit template-name</dt>
+<dd><p>Remove a template from local-project directory.</p>
+</dd>
+<dt>list</dt>
+<dd><p>Show file list and states of the files <em>type</em> <em>chmod</em> <em>rewrite</em> in templates.</p>
+</dd>
+<dt>checkout [template-name]</dt>
+<dd><p>When invoked without template-name,this command shows candidates for current templates to operate.If with template-name, this command choose the name as current template.</p>
+</dd>
+<dt>add [template-name] [files …]</dt>
+<dd><p>Add files to current template.First parameter could taken as a template-name when current template are <em>default</em>.</p>
+</dd>
+<dt>cat [template-name] [files …]</dt>
+<dd><p>Show contents in the current template.</p>
+</dd>
+<dt>edit [template-name] [files …]</dt>
+<dd><p>Edit content of files in template using <code>/usr/bin/editor</code>.</p>
+</dd>
+<dt>path [template-name] [files …]</dt>
+<dd><p>Show native path of files in template.</p>
+</dd>
+<dt>rm [template-name] [files …]</dt>
+<dd><p>Remove file form current template.</p>
+</dd>
+<dt>type [template-name] [type] [files …]</dt>
+<dd><p>Change file type. current choice for <em>type</em>s are <em>djula</em> or <em>copy</em> {{name}} {{author}} {{email}} {{universal_time}} are available variable in the template file. Withoug files, change default type.</p>
+</dd>
+<dt>chmod [template-name] [mode] [files …]</dt>
+<dd><p>Change file mode bits to generate. specify mode in octal format.</p>
+</dd>
+<dt>rewrite [template-name] file rewrite-rule</dt>
+<dd><p>Change file name using djula template.Variables {{name}} {{author}} {{email}} {{universal_time}} are available for rewrite-rule.</p>
+</dd>
+<dt>export [template-name] [directory]</dt>
+<dd><p>Export files in current template to current directory.</p>
+</dd>
+<dt>import [directory]</dt>
+<dd><p>Import template in current directory</p>
+</dd>
+<dt>help</dt>
+<dd><p>Show the subcommand help.</p>
+</dd>
+</dl>
+<!-- somecommand -->
+<!--   : description. end with a period. -->
+<h1 id="description">Description</h1>
+<p>The <em><a href="ros-template.html">ros-template</a></em>(1) command manages templates of projects.</p>
+<h2 id="create-template">Create template</h2>
+<p>First, the <code>init</code> sub-command creates an empty template.</p>
+<pre><code>$ ros template init sample-template</code></pre>
+<p>Many of sub-commands take a template name as first argument. But you can omit it by the <code>checkout</code> sub-commands. After the following, such sub-commands are applied to <code>sample-template</code>.</p>
+<pre><code>$ ros template checkout sample-template</code></pre>
+<p>Next, the <code>add</code> sub-command adds local file[s] to template. Then, the <code>list</code> sub-command shows information of files in template.</p>
+<pre><code>$ echo &quot;Hello {{ author }}!!&quot; &gt; sample.txt
+$ ros template add sample.txt
+$ ros template list
+      copy  sample.txt </code></pre>
+<p>The word <em>copy</em> means a strategy when applying the template. There are the following 2 strategies.</p>
+<ul>
+<li><em>copy</em> simply copies the file as-is.</li>
+<li><em>djula</em> processes the content of the file by template engine, <a href="http://mmontone.github.io/djula/">Djula</a>.
+<ul>
+<li>Available variables are explained later.</li>
+</ul></li>
+</ul>
+<p>The <code>type</code> sub-command changes it. In addition, default strategy (<em>copy</em>) can be changed for each template by the <code>type</code> sub-command without file names (Ex. <code>ros template type djula</code>).</p>
+<pre><code>$ ros template type djula sample.txt
+$ ros template list
+      djula sample.txt </code></pre>
+<p>The <code>sample.txt</code> will be simply output as <code>sample.txt</code> in default. But you can change it by the <code>rewrite</code> sub-command. In the following example, it will be output as <code>sample_&lt;project name&gt;.txt</code>.</p>
+<pre><code>$ ros template rewrite sample.txt &quot;sample-{{ name }}.txt&quot;
+$ ros template list
+      djula sample.txt -&gt; &quot;sample-{{ name }}.txt&quot;</code></pre>
+<p>Note: Rewrite rules are always processed by Djula irrespective of strategy of the file.</p>
+<h2 id="apply-template">Apply template</h2>
+<p><em><a href="ros-init.html">ros-init</a></em>(1) can specify a template.</p>
+<pre><code>$ mkdir temp ; cd temp
+$ ros init sample-template some-project
+$ ls
+sample-some-project.txt
+$ cat sample-some-project.txt # Assume that &quot;author&quot; is &quot;alien&quot;
+Hello alien!!</code></pre>
+<p>The file name and its content are processed by Djula as explained in the above. The following variables can be used in defaut.</p>
+<ul>
+<li>{{name}}: A project name specified in <em><a href="ros-init.html">ros-init</a></em>(1)</li>
+<li>{{author}}: An author name extracted from config of Git or <code>whoami</code></li>
+<li>{{email}}: An e-mail address extracted from config of Git or created using <code>whoami</code> and <code>hostname</code></li>
+<li>{{universal_time}}: A universal time created by <code>get-universal-time</code> function</li>
+</ul>
+<p>In addition, you can use original variables as the followings.</p>
+<pre><code>$ echo &quot;Hello {{ area }}!!&quot; &gt; sample.txt
+$ ros template add sample.txt # Note: It overwrites existing
+$ mkdir temp ; cd temp
+$ ros init sample-template roswell --area 51
+$ cat sample-roswell.txt
+Hello 51!!</code></pre>
+<h2 id="export-and-import-template">Export and import template</h2>
+<p>Basically, <em><a href="ros-template.html">ros-template</a></em>(1) is designed to internally manage added files.</p>
+<p>However, if you want to, for example, manage it using Git in a local directory or to install distributed templates, you can use the <code>export</code> and <code>import</code> sub-commands.</p>
+<p>First, the <code>export</code> sub-command exports added files and a setting file <code>roswell.init.&lt;template name&gt;.asd</code> that is internally created and editted.</p>
+<pre><code>$ ros template export dir
+$ ls dir
+roswell.init.sample-template.asd  sample.txt
+$ cat dir/sample.txt
+Hello {{ area }}!!</code></pre>
+<p>Second, the <code>import</code> sub-command imports them.</p>
+<pre><code># Assume that this is another machine...
+$ ros template list sample-template # nothing is output 
+$ ls downloaded
+roswell.init.sample-template.asd  sample.txt
+$ ros template import downloaded
+$ ros template list sample-template
+      djula sample.txt -&gt; &quot;sample-{{ name }}.txt&quot;</code></pre>
+<p>Note: If there is a template whose name is same, it will be overwritten.</p>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1) <em><a href="ros-init.html">ros-init</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-update.html

@@ -0,0 +1,41 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-update(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-update(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-update - Update system installed from vcs</p>
+<h1 id="synopsis">Synopsis</h1>
+<ul>
+<li><strong>ros update</strong> system [system …]</li>
+<li><strong>ros update</strong> method [params …]</li>
+</ul>
+<h1 id="description">Description</h1>
+<dl>
+<dt>system</dt>
+<dd><p>a name specifying a system.</p>
+</dd>
+<dt>method</dt>
+<dd><p>currently supported method is <code>git</code>.</p>
+</dd>
+</dl>
+<h1 id="update-system">Update system</h1>
+<p>When system are already installed and the system has <code>.git</code> in the system directory it invoke <code>git pull</code> and <code>ros install</code> the system.</p>
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1), <em><a href="ros-install.html">ros-install</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-use.html

@@ -0,0 +1,42 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-use(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-use(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-use - sets the default implementation used by roswell # synopsis</p>
+<p><strong>ros [options] use</strong> impl[/version]</p>
+<p>impl : The name of an implementation which is already installed. New implementations can be downloaded by <em><a href="ros-install.html">ros-install</a></em>(1). The list of installed implementations is available in <em><a href="ros-list.html">ros-list</a></em>(1).</p>
+<p>version: : The version specifier. The string representation of the version (e.g. <major>.<minor>) depends on each implementation and roswell generally follows the representation used by the implementation. In addition, <em>a special version name “system”</em> tells roswell to use the implementation that is installed in your system, which should be in PATH.</p>
+<h1 id="example">example</h1>
+<p>ros use sbcl : use the latest SBCL among several versions of SBCLs installed by <em><a href="ros-install.html">ros-install</a></em>. This is compiled from the source, which may take some time to install but allows SLIME to jump to the implementation source code.</p>
+<p>ros use sbcl-bin : use the latest stable SBCL binary downloaded from vendor’s website. Roswell uses this by default. <code>sbcl-bin</code> tends to be an older version compared to <code>sbcl</code>, but surely newer than your <em>apt-get</em> installed counterpart!</p>
+<p>ros use sbcl/1.3.1 : use the compiled SBCL 1.3.1.</p>
+<p>ros use sbcl-bin/1.3.1 : use the prebuilt SBCL 1.3.1.</p>
+<p>ros use sbcl/system : use the SBCL available in the PATH.</p>
+<p>ros use ccl : use the CCL compiled from the source. Same set of version specifiers as for SBCL can be applied.</p>
+<p>Roswell also supports <em>abcl</em>, <em>acl</em>, <em>clisp</em>, <em>cmu</em> and <em>ecl</em>.</p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!--   : description. end with a period. -->
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em>sbcl</em>(1), <em><a href="ros.html">ros</a></em>(1), <em><a href="ros-install.html">ros-install</a></em>(1), <em><a href="ros-list.html">ros-list</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros-wait.html

@@ -0,0 +1,38 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros-wait(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros-wait(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>ros-wait - # synopsis</p>
+<p><strong>ros [options] wait</strong></p>
+<!-- # subcommands -->
+<!-- somecommand -->
+<!--   : description. end with a period. -->
+<h1 id="description">Description</h1>
+<p>Wait forever after processing the options.</p>
+<p>Useful when the application should work as a background/daemonized application.</p>
+<h1 id="usecase">Usecase</h1>
+<p>This loads and launches a clack application and wait for the request from the client.</p>
+<pre><code>$ ros -sp clack -l app.lisp -e &#39;(clack:clackup)&#39; wait</code></pre>
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+<h1 id="see-also">SEE ALSO</h1>
+<p><em><a href="ros.html">ros</a></em>(1) _</p>
+</body>
+</html>

documents/html/ros.html

@@ -0,0 +1,175 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <title>ros(1)</title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <link rel="stylesheet" href="../ros.css">
+  <!--[if lt IE 9]>
+    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
+  <![endif]-->
+</head>
+<body>
+<header>
+<h1 class="title">ros(1)</h1>
+<ul>
+<li class="author">Roswell Project Team</li>
+</ul>
+</header>
+<p>Roswell - Common Lisp environment setup Utility</p>
+<h1 id="synopsis">Synopsis</h1>
+<ul>
+<li><strong>ros</strong> [<strong>options</strong>] <code>[command [args...]</code></li>
+<li><strong>ros</strong> [<strong>options</strong>] <code>[--]script [args...]</code></li>
+<li><strong>ros</strong> [<strong>options</strong>] &lt; script.ros</li>
+</ul>
+<h1 id="description">Description</h1>
+<p>Roswell is a command line tool for installing and managing Common Lisp implementations, as well as a scripting infrastructure for templating, writing, executing, compiling, distributing, downloading and installing ROSWELL-SCRIPTS written in Common Lisp.</p>
+<p>Currently roswell supports sbcl, ccl, clisp and ecl as its supported lisp implementations. For further details see <em><a href="ros-install.html">ros-install</a></em>(1).</p>
+<p>Scripts installed by roswell will be system wide if appropriate directory is included in PATH.</p>
+<h1 id="subcommands">Subcommands</h1>
+<p>In an order of utility/frequency.</p>
+<dl>
+<dt>install</dt>
+<dd><p>Install a given implementation (e.g. sbcl, ccl) or a system (e.g. alexandria) for roswell environment. See <em><a href="ros-install.html">ros-install</a></em>(1).</p>
+</dd>
+<dt>init [name[.ros]]</dt>
+<dd><p>Create a new ros script. <code>.ros</code> is optional, and is added automaticaly. See <em><a href="ros-init.html">ros-init</a></em>.</p>
+</dd>
+<dt>dump [executable|output] [script]</dt>
+<dd><p>Dump an image of the script for the faster startup or to make an executable. See <em><a href="ros-dump.html">ros-dump</a></em>.</p>
+</dd>
+<dt>build</dt>
+<dd><p>Make an executable from the script. See <em><a href="ros-build.html">ros-build</a></em>.</p>
+</dd>
+<dt>run</dt>
+<dd><p>Initiate REPL. See <em><a href="ros-run.html">ros-run</a></em>.</p>
+</dd>
+<dt>use</dt>
+<dd><p>Change the default implementation used by roswell. See <em><a href="ros-use.html">ros-use</a></em>.</p>
+</dd>
+<dt>list</dt>
+<dd><p>List the various informations. See <em><a href="ros-list.html">ros-list</a></em>.</p>
+</dd>
+<dt>config</dt>
+<dd><p>Get and set the options. See <em><a href="ros-config.html">ros-config</a></em>.</p>
+</dd>
+<dt>setup</dt>
+<dd><p>Run the initial setup. See <em><a href="ros-setup.html">ros-setup</a></em>.</p>
+</dd>
+<dt>emacs</dt>
+<dd><p>Launch emacs with slime. See <em><a href="ros-emacs.html">ros-emacs</a></em>.</p>
+</dd>
+<dt>wait</dt>
+<dd><p>Wait forever, used for daemonizing the script. See <em><a href="ros-wait.html">ros-wait</a></em>.</p>
+</dd>
+<dt>delete</dt>
+<dd><p>Delete an installed implementation. See <em><a href="ros-delete.html">ros-delete</a></em>.</p>
+</dd>
+<dt>version</dt>
+<dd><p>Show the roswell version information. See <em>ros-version</em>.</p>
+</dd>
+<dt>help</dt>
+<dd><p>Show the subcommand help.</p>
+</dd>
+</dl>
+<h1 id="options">Options</h1>
+<p>Options are processed in left-to-right order.</p>
+<dl>
+<dt>-w CODE –wrap CODE</dt>
+<dd><p>Run the script with a shell wrapper CODE, e.g. rlwrap</p>
+</dd>
+<dt>-m IMAGE –image IMAGE</dt>
+<dd><p>Continue from Lisp image IMAGE</p>
+</dd>
+<dt>-L NAME –lisp NAME</dt>
+<dd><p>Run the script with a lisp impl NAME[/VERSION] if present, e.g. sbcl-bin, sbcl/1.2.16. Fails otherwise.</p>
+</dd>
+<dt>-l FILE –load FILE</dt>
+<dd><p>Load a lisp file FILE while building</p>
+</dd>
+<dt>-S X –source-registry X</dt>
+<dd><p>Override the source registry of asdf systems.</p>
+</dd>
+<dt>-s SYSTEM –system SYSTEM</dt>
+<dd><p>Load the asdf SYSTEM while building.</p>
+</dd>
+<dt>–load-system SYSTEM</dt>
+<dd><p>Same as above (buildapp compatibility)</p>
+</dd>
+<dt>-p PACKAGE –package PACKAGE</dt>
+<dd><p>Change the current package to PACKAGE</p>
+</dd>
+<dt>-sp SP –system-package SP</dt>
+<dd><p>Combination of -s SP and -p SP</p>
+</dd>
+<dt>-e FORM –eval FORM</dt>
+<dd><p>Evaluate FORM while building</p>
+</dd>
+<dt>–require MODULE</dt>
+<dd><p>require MODULE while building</p>
+</dd>
+<dt>-q –quit</dt>
+<dd><p>quit lisp here</p>
+</dd>
+<dt>-r FUNC –restart FUNC</dt>
+<dd><p>the build image restarts from calling FUNC</p>
+</dd>
+<dt>-E FUNC –entry FUNC</dt>
+<dd><p>the build image restarts from calling (FUNC argv).</p>
+</dd>
+<dt>-i FORM –init FORM</dt>
+<dd><p>evaluate FORM after the restart.</p>
+</dd>
+<dt>-ip FORM –print FORM</dt>
+<dd><p>evaluate and princ FORM after the restart</p>
+</dd>
+<dt>-iw FORM –write FORM</dt>
+<dd><p>evaluate and write FORM after the restart</p>
+</dd>
+<dt>-F FORM –final FORM</dt>
+<dd><p>evaluate FORM before dumping the IMAGE</p>
+</dd>
+<dt>-R –rc</dt>
+<dd><p>try to read /etc/rosrc, ~/.roswell/init.lisp</p>
+</dd>
+<dt>+R –no-rc</dt>
+<dd><p>skip /etc/rosrc, ~/.roswell/init.lisp</p>
+</dd>
+<dt>-Q –quicklisp</dt>
+<dd><p>load quicklisp (default)</p>
+</dd>
+<dt>+Q –no-quicklisp</dt>
+<dd><p>do not load quicklisp</p>
+</dd>
+<dt>-v –verbose</dt>
+<dd><p>be quite verbose while building</p>
+</dd>
+<dt>–quiet</dt>
+<dd><p>suppress output while building (default)</p>
+</dd>
+<dt>–test</dt>
+<dd><p>for test purpose</p>
+</dd>
+<dt>dynamic-space-size=[size in MB]</dt>
+<dd><p>SBCL specific. The argument is passed to SBCL by <code>--dynamic-space-size</code></p>
+</dd>
+</dl>
+<h1 id="environmental-variables">Environmental Variables</h1>
+<dl>
+<dt>ROSWELL_HOME</dt>
+<dd><p>Specifies the home directory of roswell, defaulted to $HOME on Unix platform .</p>
+</dd>
+</dl>
+<!-- ROSWELL_HTML_TEST -->
+<!--  -->
+<!--   :  -->
+<h1 id="bugs">Bugs</h1>
+<p>Check out issues list (https://github.com/roswell/roswell/issues)</p>
+<h1 id="see-also">SEE ALSO</h1>
+<p><em>sbcl</em>(1) <em><a href="ros-dump.html">ros-dump</a></em>(1) <em><a href="ros-init.html">ros-init</a></em>(1) <em><a href="ros-install.html">ros-install</a></em>(1) <em><a href="ros-list.html">ros-list</a></em>(1) <em><a href="ros-setup.html">ros-setup</a></em>(1)</p>
+<p>_</p>
+</body>
+</html>

documents/make-doc-markdown.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+
+# Use this file to generate a markdown template
+
+cat > ros-$1.md <<EOF
+
+ros-$1 - 
+# synopsis
+
+**ros [options] $1** args...
+
+<!-- # subcommands -->
+
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+# description
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1)
+EOF
+

documents/man/ros-asdf.1

@@ -0,0 +1,19 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-asdf" "1" "January 2022" "" ""
+.hy
+.SH NAME
+.PP
+ros\-asdf \-
+.SH SYNOPSIS
+.PP
+\f[B]ros [options] asdf [subcommand]\f[R]
+.SH DESCRIPTION
+.PP
+\f[B]ros asdf\f[R] install and manage
+ASDF(https://common\-lisp.net/project/asdf/).
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-build.1

@@ -0,0 +1,16 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-build" "1" "" "" ""
+.hy
+.PP
+ros\-build \- Shortcut to \[lq]ros dump executable\[rq] # synopsis
+.PP
+\f[B]ros [options] build\f[R]
+.PP
+Equivalent to calling \f[C]ros dump executable <file>\f[R].
+.SH description
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-checkout.1

@@ -0,0 +1,16 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-checkout" "1" "" "" ""
+.hy
+.PP
+ros\-checkout \- # synopsis
+.PP
+\f[B]ros [options] checkout\f[R] args\&...
+.SH description
+.PP
+to enable this command ros install roswell/ql\-checkout is needed.
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-client.1

@@ -0,0 +1,30 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-client" "1" "" "" ""
+.hy
+.PP
+ros\-client \- one\-shot connect to remote repl.
+.SH synopsis
+.PP
+\f[B]ros client\f[R] protocol [options for the protocol \&...] \&...
+.SH description
+.PP
+\f[C]ros\-client\f[R] send message to lisp server and wait for message
+sent back.
+.SH swank protocol options
+.TP
+.B \f[C]\-\-port port\f[R]
+set server \f[C]port\f[R] to connect.
+default port 4005.
+.TP
+.B \f[C]\-\-interface interface\f[R]
+interface for connect.
+default is \f[C]localhost\f[R].
+.TP
+.B \-e FORM \[en]eval FORM
+Evaluate FORM while building
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1) \f[I]ros\-serve\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-config.1

@@ -0,0 +1,22 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-config" "1" "" "" ""
+.hy
+.PP
+ros\-config \- get and set options # Synopsis
+.PP
+\f[B]ros [options] config\f[R] [SUBCOMMAND ARGS\&...]
+.SH Description
+.PP
+Without any arguments, it shows all variables and it\[cq]s value.
+.TP
+.B show TARGET
+show TARGET.
+.TP
+.B set TARGET VALUE
+set the VALUE to the TARGET.
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-delete.1

@@ -0,0 +1,36 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-delete" "1" "" "" ""
+.hy
+.PP
+ros\-delete \- # synopsis
+.PP
+\f[B]ros delete\f[R] ARGS\&...
+.PP
+Slightly complex arguments.
+.SS ros delete dump IMAGES\&...
+.PP
+Whem ARGS starts with \f[C]dump\f[R], it considers the remaining args as
+the names for the dumped images.
+It then deletes the image with the given name, if it exists.
+.PP
+The deletion happens only to the images compatible with the current lisp
+implementation/version.
+For example, when ccl\-bin/1.10 and sbcl\-bin/1.3.1 both have images
+named X, and if the current lisp in use is sbcl\-bin/1.3.1, then
+\f[C]ros delete dump X\f[R] removes sbcl\-bin/1.3.1/X only.
+.SS ros delete IMPLS\&...
+.PP
+When the first argument is not \f[C]dump\f[R], then the arguments are
+treated as a list of installed implementations.
+.PP
+If a name of some implementation is given without version specifiers,
+e.g.\ sbcl\-bin, then it removes all instances (versions) of sbcl\-bin.
+.PP
+If a version is specified, then it removes only the specified instance.
+.SH description
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-dist.1

@@ -0,0 +1,14 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-dist" "1" "" "" ""
+.hy
+.PP
+ros\-dist \- # synopsis
+.PP
+\f[B]ros [options] dist\f[R] args\&...
+.SH description
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-dump.1

@@ -0,0 +1,160 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-dump" "1" "" "" ""
+.hy
+.PP
+ros\-dump \- make a dumped image of a roswell script
+.SH Synopsis
+.PP
+\f[B]ros [OPTIONS1\&...] dump [OPTIONS2\&...] MODE\f[R] args\&...
+.PP
+\f[C]OPTIONS1\f[R] specify the standard roswell options such as
+\f[C]\-L\f[R] or \f[C]\-m LISP\f[R].
+\f[C]OPTIONS2\f[R] specify the image reduction options we describe
+later.
+\f[C]MODE\f[R] is either \f[C]output\f[R] or \f[C]executable\f[R].
+.SH Description
+.PP
+\f[C]ros\-dump\f[R] creates a dumped lisp image of the state after
+processing all options \f[C]OPTIONS1\f[R].
+.PP
+It has two modes \f[C]output\f[R] and \f[C]executable\f[R].
+In both modes, the global environment (e.g.\ global binding to special
+variables such as \f[C]*package*\f[R]) of the state just after the
+restart is the environment which was effective when the script was
+dumped.
+.PP
+The dumped image is generally not compatible between the different
+implementations, and also between the versions.
+.SH Dump modes
+.SS output [\-f] [\-o OUTPUT] NAME
+.PP
+It loads the roswell script \f[C]NAME\f[R] and saves the current lisp
+state to an image.
+.PP
+The image file is by default written to an internal directory of roswell
+in an organized manner, i.e., somewhere under
+\f[C]$ROSWELL_INSTALL_DIR\f[R] deduced by the current implementation,
+its version and the given NAME.
+.PP
+When the output file already exists, the command fails with an error
+code.
+.PP
+The image can be loaded by \f[C]ros \-m IMAGE\f[R].
+When restarting from the image, standard roswell subcommands and
+additional arguments to the script are also available, for example
+\f[C]ros run\f[R] to resume with a repl, or \f[C]\-\-restart FUNC\f[R]
+to call a specific function, leaving some flexibility.
+.TP
+.B \f[C]\-o OUTPUT\f[R]
+The image is written to \f[C]OUTPUT\f[R] instead of the default
+location.
+.TP
+.B \f[C]\-f\f[R]
+Force output when the output already exists.
+.SS executable NAME [\-o OUTPUT]
+.PP
+When a script is dumped with \f[C]executable\f[R], the dumped image
+becomes an self\-contained executable binary which implies
+\f[C]\-\-restart main\f[R].
+.PP
+If \f[C]OUTPUT\f[R] is given, the resulting binary is written to this
+file.
+Otherwise, the output filename is deduced from \f[C]NAME\f[R] and is
+written in the same directory.
+On Windows and if \f[C]SCRIPT\f[R] has \f[C].ros\f[R] extension, the
+filename will be \f[C]SCRIPT.exe\f[R].
+On the other systems, the result will be \f[C]SCRIPT\f[R] (without
+extension).
+.PP
+This feature is supported on SBCL, CCL, CMUCL, CLISP, ECL.
+.SH Image Reduction Options
+.PP
+These options unlink some references to the runtime objects and allow
+gcs to reclaim some memory, which eventually reduces the size of the
+dumped image.
+.PP
+Care should be taken to ensure the resulting program works as expected,
+as some of these operation may destroy the common assumptions of the
+conforming programs.
+For example, package\-related reduction options may inhibit the runtime
+calls to \f[C]READ\f[R] after the restart.
+.PP
+Reduction options are processed in the left\-to\-right manner.
+.TP
+.B \[en]disable\-compression, \[en]enable\-compression, \-c
+These options disable/enable/enable the core compression feature in
+SBCL.
+Thus this option is meaningful only on SBCL.
+Compression is enabled by default.
+.TP
+.B \[en]remove\-docstrings
+This option removes all docstrings from all symbols in the entire lisp
+image.
+.TP
+.B \[en]delete\-package PKG
+This option can be specified multiple times.
+It uninterns the symbols in PACKAGE, calls \f[C]makeunbound\f[R] and
+\f[C]fmakeunbound\f[R] on each symbol and deletes the package.
+Package names are automatically string\-upcase\[cq]d.
+.TP
+.B \[en]delete\-all\-packages
+This option applies \[en]delete\-package PKG on all packages, except
+some blacklisted packages (keyword, roswell, ROS.SCRIPT.DUMP, and the
+package of the main function symbol).
+.TP
+.B \[en]delete\-packages\-except PACKAGE
+This option can be specified multiple times.
+It is identical to \[en]delete\-all\-packages except that it adds
+PACKAGE to the blacklist.
+Package names are automatically string\-upcase\[cq]d.
+.TP
+.B \[en]destroy\-packages\-sbcl
+This is an sbcl\-specific option which is even more aggressive than the
+above methods (>10MB reduction).
+It destroys the package system by modifying the internal tables for
+packages, cleaning up the caches for package\-use\-list etc.
+The blacklist is shared among \[en]delete\-all\-packages and
+\[en]destroy\-packages\-sbcl.
+However, this method does not call fmakunbound/makunbound, so combining
+the two methods can result in a more aggressive image size reduction.
+Due to the nature of this option, it is desirable to specify it as the
+last method (i.e.\ rightmost).
+.TP
+.B \[en]purify, \[en]no\-purify
+This is common to CCL, SBCL, CMUCL.
+Moves all objects to the static space where GC does not scan, for the
+later performance of GC.
+Purification is enabled by default.
+.TP
+.B \[en]impurify, \[en]no\-impurify
+This is an CCL\-specific option (enabled by default).
+It moves all objects to the dynamic space before saving the image.
+This allows the static\-space objects to be GC\[cq]ed.
+When purification is enabled, it impurifies all objects before running
+the purifying GC.
+.TP
+.B \[en]delete\-debug\-info
+This removes the debug infomation of functions (used to show the stack
+frame etc), as well as the source locations and the deprecation
+information of various symbols.
+SBCL only.
+This option has a large effect (+10MB reduction).
+.TP
+.B \[en]delete\-macro\-definitions, \[en]delete\-compiler\-macro\-definitions
+This removes all definitions of macros and compiler\-macros, assuming
+that no runtime compilation/interpretation of code will be performed.
+This option should be portable across implementations.
+It has \[ti]2MB reduction on SBCL.
+.TP
+.B \[en]delete\-compiler\-information\-sbcl
+This is an SBCL\-specific option which is more aggressive than the above
+methods (\[ti]4MB reduction).
+In addition to the macro and the compiler\-macro definitions, it
+destroys the internal compiler systems of SBCL by also removing the
+inlining information, IR1 transformer and IR2 (VOP).
+.SH SEE ALSO
+.PP
+\f[I]sbcl\f[R](1) \f[I]ros\f[R](1) \f[I]ros\-init\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-emacs.1

@@ -0,0 +1,19 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-emacs" "1" "" "" ""
+.hy
+.PP
+ros\-emacs \- launch Emacs with Slime # Synopsis
+.PP
+\f[B]ros emacs\f[R] [ARGS\&...]
+.SH Description
+.PP
+Launches Emacs with a Slime(https://common\-lisp.net/project/slime/)
+buffer opened, which is connected to the back\-end lisp implementation
+of roswell.
+Additional arguments are passed to emacs.
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1), \f[I]emacs\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-help.1

@@ -0,0 +1,17 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-help" "1" "" "" ""
+.hy
+.PP
+ros\-help \- Show Command help
+.SH Synopsis
+.PP
+\f[B]ros help\f[R] [subcommand or topics]
+.SH Description
+.PP
+\f[B]ros help\f[R] shows description of subcommand or topics
+.SH SEE ALSO
+.PP
+\f[I]sbcl\f[R](1), \f[I]ros\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-init.1

@@ -0,0 +1,69 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-init" "1" "" "" ""
+.hy
+.PP
+ros\-init \- Create a roswell script (optionally based on a template)
+.SH Synopsis
+.PP
+\f[B]ros init [TEMPLATE] NAME [ARGS\&...]]\f[R]
+.TP
+.B TEMPLATE
+Specifies the name of a template, defaulted to \f[I]default\f[R]
+template.
+However, if \f[I]TEMPLATE\f[R] is not specified and \f[I]FILENAME\f[R]
+matches one of the templates being stored, then it automatically uses
+the template.
+To suppress this behavior, you should explicitly specify
+\f[I]TEMPLATE\f[R] as \f[I]default\f[R].
+.RS
+.PP
+Thus you are warned when you use this command from a shell script.
+In order to achieve a consistent and desired behavior, it is adviced
+that they should always explicitly specify the template name.
+.RE
+.TP
+.B NAME
+Specify the output filename, or \[lq]\-\[rq] to indicate
+\f[I]stdout\f[R].
+When \f[I]TEMPLATE\f[R] is \f[I]default\f[R], it automatically appends a
+file type \[lq].ros\[rq].
+.SH Description
+.PP
+Initialises a roswell file based on a template.
+User\-specified templates can be added by \f[I]ros\-template\f[R](1).
+.PP
+The default template is something like:
+.IP
+.nf
+\f[C]
+#!/bin/sh
+#|\-*\- mode:lisp \-*\-|#
+#| <Put a one\-line description here>
+exec ros \-Q \-\- $0 \[dq]$\[at]\[dq]
+|#
+(progn ;;init forms
+  (ros:ensure\-asdf)
+  ;;#+quicklisp (ql:quickload \[aq]() :silent t)
+  )
+
+(defpackage :ros.script.test.3703600390
+  (:use :cl))
+(in\-package :ros.script.test.3703600390)
+
+(defun main (&rest argv)
+  (declare (ignorable argv)))
+;;; vim: set ft=lisp lisp:
+\f[R]
+.fi
+.PP
+This is basically a shell script which immediately invokes Roswell by
+exec (see \f[I]sh(1)\f[R]).
+Roswell loads the same script as an input, skips multi\-line comments,
+reads the rest of the file as a Common Lisp program, and finally invokes
+a function main with command\-line arguments.
+.SH SEE ALSO
+.PP
+\f[I]sbcl\f[R](1) \f[I]ros\f[R](1) \f[I]ros\-template\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-install.1

@@ -0,0 +1,121 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-install" "1" "" "" ""
+.hy
+.PP
+ros\-install \- Install lisp implementations or quicklisp system
+.SH Synopsis
+.IP \[bu] 2
+\f[B]ros install\f[R] system [system \&...]
+.IP \[bu] 2
+\f[B]ros install\f[R] impl[/version] [param \&...]
+.SH Description
+.TP
+.B system
+a name specifying a system.
+.TP
+.B impl
+a name specifying a lisp implementation.
+.SH Installing a Lisp Implementation
+.PP
+When the \f[C]impl\f[R] or \f[C]system\f[R] matches to one of the
+supported implementations, it fetches, downloads and installs it to one
+of the internal directory managed by roswell (\[ti]/.roswell, or
+\f[C]ROSWELL_INSTALL_DIR\f[R]).
+In order to use the installed implementation, you have to run
+\f[I]ros\-use(1)\f[R].
+.PP
+For example, the following command downloads the latest sbcl binary from
+sbcl.org.
+Note that this may be different from the default binary installed by
+roswell, called \f[C]sbcl\-bin\f[R].
+\f[C]sbcl\-bin\f[R] is a stable and well\-tested version of the sbcl
+binary which is supposed to be a little older than the latest sbcl.
+.IP
+.nf
+\f[C]
+$ ros install sbcl
+\f[R]
+.fi
+.PP
+When invoked without a name, it prints the list of installable
+implementations.
+(Not to be confused with \f[C]ros list installed\f[R], which shows the
+implementations already installed.)
+.IP
+.nf
+\f[C]
+Usage: ros install impl [OPTIONS]
+
+For more details on impl specific options, type:
+ros help install impl
+
+Candidates impls for installation are:
+ecl
+sbcl
+clisp
+ccl\-bin
+sbcl\-bin
+\f[R]
+.fi
+.PP
+The name can be optionally followed by a slash \f[C]/\f[R] and a version
+of the implementation.
+.IP
+.nf
+\f[C]
+$ ros install sbcl/1.2.14
+\f[R]
+.fi
+.PP
+There might be some \f[I]hidden\f[R] implementation that are not listed
+here \[em] they are in the alpha quality, but try the one you like or
+watch the website (https://github.com/roswell/roswell).
+.IP
+.nf
+\f[C]
+$ ros install ccl
+$ ros install abcl
+$ ...
+\f[R]
+.fi
+.SH Installing a quicklisp system and the bundled roswell scripts
+.PP
+If the specified name does not match any of the implementations, roswell
+tries to find a quicklisp system of the given name.
+.IP
+.nf
+\f[C]
+$ ros install alexandria
+\f[R]
+.fi
+.PP
+After compiling and loading the system, it funcalls
+\f[C]ros:*build\-hook*\f[R] special variable with no argument, if some
+function is set during the compilation/load.
+.PP
+When the system comes with a \f[B]roswell script\f[R] created by
+\f[I]ros\-init\f[R](1) in the subdirectory \f[C]roswell\f[R], they are
+installed into \f[B]ROSWELL_INSTALL_DIR/bin\f[R].
+Setting the path to this directory makes those scripts available from
+the shell command line.
+.IP
+.nf
+\f[C]
+$ ros install qlot
+System \[aq]qlot\[aq] found. Loading the system..
+Processing build\-hook..
+Found 1 scripts: qlot
+Attempting to install the scripts in roswell/ subdirectory of the system...
+/home/user/.roswell/bin/qlot
+
+$ qlot
+Usage: qlot [install | update | bundle | exec shell\-args..]
+\f[R]
+.fi
+.SH SEE ALSO
+.PP
+\f[I]sbcl\f[R](1), \f[I]ros\f[R](1), \f[I]ros\-list\f[R](1),
+\f[I]ros\-init\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-list.1

@@ -0,0 +1,34 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-list" "1" "" "" ""
+.hy
+.PP
+ros\-list \- list the materials installed by roswell
+.SH Synopsis
+.PP
+\f[B]ros list [type] [options]\f[R]
+.SH Description
+.PP
+\f[B]ros list\f[R] shows the list of the materials installed by roswell.
+.TP
+.B installed [ [ IMPL | IMPL/VERSION ]\&...]
+List the implementations that have been already installed.
+Optionally providing IMPL shows the installed versions of the
+implementation.
+.TP
+.B dump [IMPL]
+List the internal dumped images that are compatible with IMPL.
+When IMPL is ommited, it is defaulted to the current lisp implementation
+in use.
+Images are in \f[C]$ROSWELL_INSTALL_DIR/impl/.../dump/\f[R].
+.TP
+.B versions [IMPL]
+List the installable versions for IMPL.
+When IMPL is ommited, it is defaulted to the current lisp implementation
+in use.
+This feature is experimental.
+.SH SEE ALSO
+.PP
+\f[I]sbcl\f[R](1) \f[I]ros\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-run.1

@@ -0,0 +1,17 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-run" "1" "" "" ""
+.hy
+.PP
+ros\-run \- start a REPL # Synopsis
+.PP
+\f[B]ros [options] run\f[R]
+.SH Description
+.PP
+Processes the given options and start a REPL using the currently
+effective lisp implementation set by \f[I]ros\-use\f[R](1).
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-serve.1

@@ -0,0 +1,27 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-serve" "1" "" "" ""
+.hy
+.PP
+ros\-serve \- start lisp server
+.SH Synopsis
+.PP
+\f[B]ros [options for roswell \&... ] serve\f[R] protocol [options for
+the protocol \&...] \&...
+.SH description
+.PP
+\f[C]ros\-serve\f[R] start lisp and wait for clients to connect to the
+lisp.
+.SH swank protocol options
+.TP
+.B \f[C]\-\-port port\f[R]
+Listen port would be \f[C]port\f[R] instead of the default port 4005.
+.TP
+.B \f[C]\-\-interface interface\f[R]
+limit interface for listen.
+default is \f[C]localhost\f[R] so there would be no limitation.
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1) \f[I]ros\-client\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-setup.1

@@ -0,0 +1,27 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-setup" "1" "" "" ""
+.hy
+.PP
+ros\-setup \- setup the backend of roswell
+.SH Synopsis
+.PP
+\f[B]ros setup\f[R]
+.SH Description
+.PP
+\f[B]ros setup\f[R] initializes roswell.
+The process includes the following steps:
+.IP \[bu] 2
+Downloading the default stable lisp implementation (sbcl\-bin) to
+\f[C]ROSWELL_INSTALL_DIR\f[R].
+.IP \[bu] 2
+Installing quicklisp to \f[C]ROSWELL_INSTALL_DIR\f[R].
+.IP \[bu] 2
+On Windows, install 7zip to \f[C]ROSWELL_INSTALL_DIR\f[R].
+.IP \[bu] 2
+Making the core image of roswell itself.
+.SH SEE ALSO
+.PP
+\f[I]sbcl\f[R](1), \f[I]ros\f[R](1), section Environmental Variables
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-template.1

@@ -0,0 +1,228 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-template" "1" "" "" ""
+.hy
+.PP
+ros\-template \- Edit template for ros\-init
+.SH synopsis
+.IP \[bu] 2
+\f[B]ros template\f[R] command args\&...
+.SH Subcommands
+.TP
+.B init template\-name
+Create new template in local\-project directory.
+.TP
+.B deinit template\-name
+Remove a template from local\-project directory.
+.TP
+.B list
+Show file list and states of the files \f[I]type\f[R] \f[I]chmod\f[R]
+\f[I]rewrite\f[R] in templates.
+.TP
+.B checkout [template\-name]
+When invoked without template\-name,this command shows candidates for
+current templates to operate.If with template\-name, this command choose
+the name as current template.
+.TP
+.B add [template\-name] [files \&...]
+Add files to current template.First parameter could taken as a
+template\-name when current template are \f[I]default\f[R].
+.TP
+.B cat [template\-name] [files \&...]
+Show contents in the current template.
+.TP
+.B edit [template\-name] [files \&...]
+Edit content of files in template using \f[C]/usr/bin/editor\f[R].
+.TP
+.B path [template\-name] [files \&...]
+Show native path of files in template.
+.TP
+.B rm [template\-name] [files \&...]
+Remove file form current template.
+.TP
+.B type [template\-name] [type] [files \&...]
+Change file type.
+current choice for \f[I]type\f[R]s are \f[I]djula\f[R] or \f[I]copy\f[R]
+{{name}} {{author}} {{email}} {{universal_time}} are available variable
+in the template file.
+Withoug files, change default type.
+.TP
+.B chmod [template\-name] [mode] [files \&...]
+Change file mode bits to generate.
+specify mode in octal format.
+.TP
+.B rewrite [template\-name] file rewrite\-rule
+Change file name using djula template.Variables {{name}} {{author}}
+{{email}} {{universal_time}} are available for rewrite\-rule.
+.TP
+.B export [template\-name] [directory]
+Export files in current template to current directory.
+.TP
+.B import [directory]
+Import template in current directory
+.TP
+.B help
+Show the subcommand help.
+.SH Description
+.PP
+The \f[I]ros\-template\f[R](1) command manages templates of projects.
+.SS Create template
+.PP
+First, the \f[C]init\f[R] sub\-command creates an empty template.
+.IP
+.nf
+\f[C]
+$ ros template init sample\-template
+\f[R]
+.fi
+.PP
+Many of sub\-commands take a template name as first argument.
+But you can omit it by the \f[C]checkout\f[R] sub\-commands.
+After the following, such sub\-commands are applied to
+\f[C]sample\-template\f[R].
+.IP
+.nf
+\f[C]
+$ ros template checkout sample\-template
+\f[R]
+.fi
+.PP
+Next, the \f[C]add\f[R] sub\-command adds local file[s] to template.
+Then, the \f[C]list\f[R] sub\-command shows information of files in
+template.
+.IP
+.nf
+\f[C]
+$ echo \[dq]Hello {{ author }}!!\[dq] > sample.txt
+$ ros template add sample.txt
+$ ros template list
+      copy  sample.txt 
+\f[R]
+.fi
+.PP
+The word \f[I]copy\f[R] means a strategy when applying the template.
+There are the following 2 strategies.
+.IP \[bu] 2
+\f[I]copy\f[R] simply copies the file as\-is.
+.IP \[bu] 2
+\f[I]djula\f[R] processes the content of the file by template engine,
+Djula (http://mmontone.github.io/djula/).
+.RS 2
+.IP \[bu] 2
+Available variables are explained later.
+.RE
+.PP
+The \f[C]type\f[R] sub\-command changes it.
+In addition, default strategy (\f[I]copy\f[R]) can be changed for each
+template by the \f[C]type\f[R] sub\-command without file names (Ex.
+\f[C]ros template type djula\f[R]).
+.IP
+.nf
+\f[C]
+$ ros template type djula sample.txt
+$ ros template list
+      djula sample.txt 
+\f[R]
+.fi
+.PP
+The \f[C]sample.txt\f[R] will be simply output as \f[C]sample.txt\f[R]
+in default.
+But you can change it by the \f[C]rewrite\f[R] sub\-command.
+In the following example, it will be output as
+\f[C]sample_<project name>.txt\f[R].
+.IP
+.nf
+\f[C]
+$ ros template rewrite sample.txt \[dq]sample\-{{ name }}.txt\[dq]
+$ ros template list
+      djula sample.txt \-> \[dq]sample\-{{ name }}.txt\[dq]
+\f[R]
+.fi
+.PP
+Note: Rewrite rules are always processed by Djula irrespective of
+strategy of the file.
+.SS Apply template
+.PP
+\f[I]ros\-init\f[R](1) can specify a template.
+.IP
+.nf
+\f[C]
+$ mkdir temp ; cd temp
+$ ros init sample\-template some\-project
+$ ls
+sample\-some\-project.txt
+$ cat sample\-some\-project.txt # Assume that \[dq]author\[dq] is \[dq]alien\[dq]
+Hello alien!!
+\f[R]
+.fi
+.PP
+The file name and its content are processed by Djula as explained in the
+above.
+The following variables can be used in defaut.
+.IP \[bu] 2
+{{name}}: A project name specified in \f[I]ros\-init\f[R](1)
+.IP \[bu] 2
+{{author}}: An author name extracted from config of Git or
+\f[C]whoami\f[R]
+.IP \[bu] 2
+{{email}}: An e\-mail address extracted from config of Git or created
+using \f[C]whoami\f[R] and \f[C]hostname\f[R]
+.IP \[bu] 2
+{{universal_time}}: A universal time created by
+\f[C]get\-universal\-time\f[R] function
+.PP
+In addition, you can use original variables as the followings.
+.IP
+.nf
+\f[C]
+$ echo \[dq]Hello {{ area }}!!\[dq] > sample.txt
+$ ros template add sample.txt # Note: It overwrites existing
+$ mkdir temp ; cd temp
+$ ros init sample\-template roswell \-\-area 51
+$ cat sample\-roswell.txt
+Hello 51!!
+\f[R]
+.fi
+.SS Export and import template
+.PP
+Basically, \f[I]ros\-template\f[R](1) is designed to internally manage
+added files.
+.PP
+However, if you want to, for example, manage it using Git in a local
+directory or to install distributed templates, you can use the
+\f[C]export\f[R] and \f[C]import\f[R] sub\-commands.
+.PP
+First, the \f[C]export\f[R] sub\-command exports added files and a
+setting file \f[C]roswell.init.<template name>.asd\f[R] that is
+internally created and editted.
+.IP
+.nf
+\f[C]
+$ ros template export dir
+$ ls dir
+roswell.init.sample\-template.asd  sample.txt
+$ cat dir/sample.txt
+Hello {{ area }}!!
+\f[R]
+.fi
+.PP
+Second, the \f[C]import\f[R] sub\-command imports them.
+.IP
+.nf
+\f[C]
+# Assume that this is another machine...
+$ ros template list sample\-template # nothing is output 
+$ ls downloaded
+roswell.init.sample\-template.asd  sample.txt
+$ ros template import downloaded
+$ ros template list sample\-template
+      djula sample.txt \-> \[dq]sample\-{{ name }}.txt\[dq]
+\f[R]
+.fi
+.PP
+Note: If there is a template whose name is same, it will be overwritten.
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1) \f[I]ros\-init\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-update.1

@@ -0,0 +1,28 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-update" "1" "" "" ""
+.hy
+.PP
+ros\-update \- Update system installed from vcs
+.SH Synopsis
+.IP \[bu] 2
+\f[B]ros update\f[R] system [system \&...]
+.IP \[bu] 2
+\f[B]ros update\f[R] method [params \&...]
+.SH Description
+.TP
+.B system
+a name specifying a system.
+.TP
+.B method
+currently supported method is \f[C]git\f[R].
+.SH Update system
+.PP
+When system are already installed and the system has \f[C].git\f[R] in
+the system directory it invoke \f[C]git pull\f[R] and
+\f[C]ros install\f[R] the system.
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1), \f[I]ros\-install\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-use.1

@@ -0,0 +1,52 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-use" "1" "" "" ""
+.hy
+.PP
+ros\-use \- sets the default implementation used by roswell # synopsis
+.PP
+\f[B]ros [options] use\f[R] impl[/version]
+.PP
+impl : The name of an implementation which is already installed.
+New implementations can be downloaded by \f[I]ros\-install\f[R](1).
+The list of installed implementations is available in
+\f[I]ros\-list\f[R](1).
+.PP
+version: : The version specifier.
+The string representation of the version (e.g.\ .) depends on each
+implementation and roswell generally follows the representation used by
+the implementation.
+In addition, \f[I]a special version name \[lq]system\[rq]\f[R] tells
+roswell to use the implementation that is installed in your system,
+which should be in PATH.
+.SH example
+.PP
+ros use sbcl : use the latest SBCL among several versions of SBCLs
+installed by \f[I]ros\-install\f[R].
+This is compiled from the source, which may take some time to install
+but allows SLIME to jump to the implementation source code.
+.PP
+ros use sbcl\-bin : use the latest stable SBCL binary downloaded from
+vendor\[cq]s website.
+Roswell uses this by default.
+\f[C]sbcl\-bin\f[R] tends to be an older version compared to
+\f[C]sbcl\f[R], but surely newer than your \f[I]apt\-get\f[R] installed
+counterpart!
+.PP
+ros use sbcl/1.3.1 : use the compiled SBCL 1.3.1.
+.PP
+ros use sbcl\-bin/1.3.1 : use the prebuilt SBCL 1.3.1.
+.PP
+ros use sbcl/system : use the SBCL available in the PATH.
+.PP
+ros use ccl : use the CCL compiled from the source.
+Same set of version specifiers as for SBCL can be applied.
+.PP
+Roswell also supports \f[I]abcl\f[R], \f[I]acl\f[R], \f[I]clisp\f[R],
+\f[I]cmu\f[R] and \f[I]ecl\f[R].
+.SH SEE ALSO
+.PP
+\f[I]sbcl\f[R](1), \f[I]ros\f[R](1), \f[I]ros\-install\f[R](1),
+\f[I]ros\-list\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros-wait.1

@@ -0,0 +1,29 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros-wait" "1" "" "" ""
+.hy
+.PP
+ros\-wait \- # synopsis
+.PP
+\f[B]ros [options] wait\f[R]
+.SH Description
+.PP
+Wait forever after processing the options.
+.PP
+Useful when the application should work as a background/daemonized
+application.
+.SH Usecase
+.PP
+This loads and launches a clack application and wait for the request
+from the client.
+.IP
+.nf
+\f[C]
+$ ros \-sp clack \-l app.lisp \-e \[aq](clack:clackup)\[aq] wait
+\f[R]
+.fi
+.SH SEE ALSO
+.PP
+\f[I]ros\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/man/ros.1

@@ -0,0 +1,185 @@
+.\" Automatically generated by Pandoc 2.5
+.\"
+.TH "ros" "1" "" "" ""
+.hy
+.PP
+Roswell \- Common Lisp environment setup Utility
+.SH Synopsis
+.IP \[bu] 2
+\f[B]ros\f[R] [\f[B]options\f[R]] \f[C][command [args...]\f[R]
+.IP \[bu] 2
+\f[B]ros\f[R] [\f[B]options\f[R]] \f[C][\-\-]script [args...]\f[R]
+.IP \[bu] 2
+\f[B]ros\f[R] [\f[B]options\f[R]] < script.ros
+.SH Description
+.PP
+Roswell is a command line tool for installing and managing Common Lisp
+implementations, as well as a scripting infrastructure for templating,
+writing, executing, compiling, distributing, downloading and installing
+ROSWELL\-SCRIPTS written in Common Lisp.
+.PP
+Currently roswell supports sbcl, ccl, clisp and ecl as its supported
+lisp implementations.
+For further details see \f[I]ros\-install\f[R](1).
+.PP
+Scripts installed by roswell will be system wide if appropriate
+directory is included in PATH.
+.SH Subcommands
+.PP
+In an order of utility/frequency.
+.TP
+.B install
+Install a given implementation (e.g.\ sbcl, ccl) or a system
+(e.g.\ alexandria) for roswell environment.
+See \f[I]ros\-install\f[R](1).
+.TP
+.B init [name[.ros]]
+Create a new ros script.
+\f[C].ros\f[R] is optional, and is added automaticaly.
+See \f[I]ros\-init\f[R].
+.TP
+.B dump [executable|output] [script]
+Dump an image of the script for the faster startup or to make an
+executable.
+See \f[I]ros\-dump\f[R].
+.TP
+.B build
+Make an executable from the script.
+See \f[I]ros\-build\f[R].
+.TP
+.B run
+Initiate REPL.
+See \f[I]ros\-run\f[R].
+.TP
+.B use
+Change the default implementation used by roswell.
+See \f[I]ros\-use\f[R].
+.TP
+.B list
+List the various informations.
+See \f[I]ros\-list\f[R].
+.TP
+.B config
+Get and set the options.
+See \f[I]ros\-config\f[R].
+.TP
+.B setup
+Run the initial setup.
+See \f[I]ros\-setup\f[R].
+.TP
+.B emacs
+Launch emacs with slime.
+See \f[I]ros\-emacs\f[R].
+.TP
+.B wait
+Wait forever, used for daemonizing the script.
+See \f[I]ros\-wait\f[R].
+.TP
+.B delete
+Delete an installed implementation.
+See \f[I]ros\-delete\f[R].
+.TP
+.B version
+Show the roswell version information.
+See \f[I]ros\-version\f[R].
+.TP
+.B help
+Show the subcommand help.
+.SH Options
+.PP
+Options are processed in left\-to\-right order.
+.TP
+.B \-w CODE \[en]wrap CODE
+Run the script with a shell wrapper CODE, e.g.\ rlwrap
+.TP
+.B \-m IMAGE \[en]image IMAGE
+Continue from Lisp image IMAGE
+.TP
+.B \-L NAME \[en]lisp NAME
+Run the script with a lisp impl NAME[/VERSION] if present,
+e.g.\ sbcl\-bin, sbcl/1.2.16.
+Fails otherwise.
+.TP
+.B \-l FILE \[en]load FILE
+Load a lisp file FILE while building
+.TP
+.B \-S X \[en]source\-registry X
+Override the source registry of asdf systems.
+.TP
+.B \-s SYSTEM \[en]system SYSTEM
+Load the asdf SYSTEM while building.
+.TP
+.B \[en]load\-system SYSTEM
+Same as above (buildapp compatibility)
+.TP
+.B \-p PACKAGE \[en]package PACKAGE
+Change the current package to PACKAGE
+.TP
+.B \-sp SP \[en]system\-package SP
+Combination of \-s SP and \-p SP
+.TP
+.B \-e FORM \[en]eval FORM
+Evaluate FORM while building
+.TP
+.B \[en]require MODULE
+require MODULE while building
+.TP
+.B \-q \[en]quit
+quit lisp here
+.TP
+.B \-r FUNC \[en]restart FUNC
+the build image restarts from calling FUNC
+.TP
+.B \-E FUNC \[en]entry FUNC
+the build image restarts from calling (FUNC argv).
+.TP
+.B \-i FORM \[en]init FORM
+evaluate FORM after the restart.
+.TP
+.B \-ip FORM \[en]print FORM
+evaluate and princ FORM after the restart
+.TP
+.B \-iw FORM \[en]write FORM
+evaluate and write FORM after the restart
+.TP
+.B \-F FORM \[en]final FORM
+evaluate FORM before dumping the IMAGE
+.TP
+.B \-R \[en]rc
+try to read /etc/rosrc, \[ti]/.roswell/init.lisp
+.TP
+.B +R \[en]no\-rc
+skip /etc/rosrc, \[ti]/.roswell/init.lisp
+.TP
+.B \-Q \[en]quicklisp
+load quicklisp (default)
+.TP
+.B +Q \[en]no\-quicklisp
+do not load quicklisp
+.TP
+.B \-v \[en]verbose
+be quite verbose while building
+.TP
+.B \[en]quiet
+suppress output while building (default)
+.TP
+.B \[en]test
+for test purpose
+.TP
+.B dynamic\-space\-size=[size in MB]
+SBCL specific.
+The argument is passed to SBCL by \f[C]\-\-dynamic\-space\-size\f[R]
+.SH Environmental Variables
+.TP
+.B ROSWELL_HOME
+Specifies the home directory of roswell, defaulted to $HOME on Unix
+platform .
+.SH Bugs
+.PP
+Check out issues list (https://github.com/roswell/roswell/issues)
+.SH SEE ALSO
+.PP
+\f[I]sbcl\f[R](1) \f[I]ros\-dump\f[R](1) \f[I]ros\-init\f[R](1)
+\f[I]ros\-install\f[R](1) \f[I]ros\-list\f[R](1) \f[I]ros\-setup\f[R](1)
+.SH AUTHORS
+Roswell Project Team.

documents/ros-asdf.md

@@ -0,0 +1,28 @@
+% ros-asdf(1)
+% Roswell Project Team
+% January 2022
+
+# NAME
+
+ros-asdf - 
+
+# SYNOPSIS
+
+**ros [options] asdf [subcommand]**
+
+<!-- # subcommands -->
+
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+# DESCRIPTION
+
+**ros asdf** install and manage ASDF(https://common-lisp.net/project/asdf/).
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1)

documents/ros-build.md

@@ -0,0 +1,22 @@
+
+ros-build - Shortcut to "ros dump executable"
+# synopsis
+
+**ros [options] build** <file>
+
+Equivalent to calling `ros dump executable <file>`.
+
+<!-- # subcommands -->
+
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+# description
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1)

documents/ros-checkout.md

@@ -0,0 +1,22 @@
+
+ros-checkout - 
+# synopsis
+
+**ros [options] checkout** args...
+
+<!-- # subcommands -->
+
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+# description
+
+to enable this command ros install roswell/ql-checkout is needed.
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1)

documents/ros-client.md

@@ -0,0 +1,35 @@
+ros-client - one-shot connect to remote repl.
+
+# synopsis
+
+**ros client** protocol [options for the protocol ...] ...
+
+<!-- # subcommands -->
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+# description
+
+`ros-client` send message to lisp server and wait for message sent back.
+
+# swank protocol options
+
+`--port port`
+
+  : set server `port` to connect. default port 4005.
+
+`--interface interface`
+
+  : interface for connect. default is `localhost`.
+
+-e FORM     --eval FORM
+
+  : Evaluate FORM while building
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1) _ros-serve_(1)

documents/ros-config.md

@@ -0,0 +1,25 @@
+
+ros-config - get and set options
+# Synopsis
+
+**ros [options] config** [SUBCOMMAND ARGS...]
+
+# Description
+
+Without any arguments, it shows all variables and it's value.
+
+show TARGET
+
+  : show TARGET.
+
+
+set TARGET VALUE
+
+  : set the VALUE to the TARGET.
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1)

documents/ros-delete.md

@@ -0,0 +1,40 @@
+
+ros-delete - 
+# synopsis
+
+**ros delete** ARGS...
+
+Slightly complex arguments.
+
+## ros delete dump IMAGES...
+
+Whem ARGS starts with `dump`, it considers the remaining args as the names for the dumped images.
+It then deletes the image with the given name, if it exists.
+
+The deletion happens only to the images compatible with the current lisp
+implementation/version.  For example, when ccl-bin/1.10 and sbcl-bin/1.3.1
+both have images named X, and if the current lisp in use is sbcl-bin/1.3.1,
+then `ros delete dump X` removes sbcl-bin/1.3.1/X only.
+
+## ros delete IMPLS...
+
+When the first argument is not `dump`, then the arguments are treated as a
+list of installed implementations.
+
+If a name of some implementation is given without version specifiers,
+e.g. sbcl-bin, then it removes all instances (versions) of sbcl-bin.
+
+If a version is specified, then it removes only the specified instance.
+
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+# description
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1)

documents/ros-dist.md

@@ -0,0 +1,20 @@
+
+ros-dist - 
+# synopsis
+
+**ros [options] dist** args...
+
+<!-- # subcommands -->
+
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+# description
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1)

documents/ros-dump.md

@@ -0,0 +1,154 @@
+ros-dump - make a dumped image of a roswell script
+
+# Synopsis
+
+**ros [OPTIONS1...] dump [OPTIONS2...] MODE** args...
+
+`OPTIONS1` specify the standard roswell options such as `-L` or `-m LISP`.
+`OPTIONS2` specify the image reduction options we describe later.
+`MODE` is either `output` or `executable`.
+
+# Description
+
+`ros-dump` creates a dumped lisp image of the state after processing all
+options `OPTIONS1`.
+
+It has two modes `output` and `executable`.
+In both modes, the global environment (e.g. global binding to special
+variables such as `*package*`) of the state just after the restart is
+the environment which was effective when the script was dumped.
+
+<!-- Fixme: what kind of? this is unnecessarily retracting the users from using this feature -->
+<!-- There might be a limitation regarding this feature depending on the lisp -->
+<!-- implementation used by roswell at the time of building.   -->
+
+The dumped image is generally not compatible between the different
+implementations, and also between the versions.
+
+# Dump modes
+
+## output [-f] [-o OUTPUT] NAME
+
+It loads the roswell script `NAME` and saves the current lisp state to an image.
+
+The image file is by default written to an internal directory of roswell in an organized manner,
+i.e., somewhere under `$ROSWELL_INSTALL_DIR` deduced by the current
+implementation, its version and the given NAME.
+
+When the output file already exists, the command fails with an error code.
+
+The image can be loaded by `ros -m IMAGE`. When restarting from the image, standard roswell
+subcommands and additional arguments to the script are also available, for
+example `ros run` to resume with a repl, or `--restart FUNC` to call a
+specific function, leaving some flexibility.
+
+`-o OUTPUT`
+
+  : The image is written to `OUTPUT` instead of the default location.
+
+`-f`
+
+  : Force output when the output already exists.
+
+## executable NAME [-o OUTPUT]
+
+When a script is dumped with `executable`, the dumped image
+becomes an self-contained executable binary which implies `--restart main`.
+
+If `OUTPUT` is given, the resulting binary is written to this file.
+Otherwise, the output filename is deduced from `NAME` and is written in the same directory.
+On Windows and if `SCRIPT` has `.ros` extension, the filename will be `SCRIPT.exe`.
+On the other systems, the result will be `SCRIPT` (without extension).
+
+This feature is supported on SBCL, CCL, CMUCL, CLISP, ECL.
+
+# Image Reduction Options
+
+These options unlink some references to the runtime objects and allow gcs to
+reclaim some memory, which eventually reduces the size of the dumped image.
+
+Care should be taken to ensure the resulting program works as expected, as some
+of these operation may destroy the common assumptions of the conforming
+programs. For example, package-related reduction options may inhibit the runtime
+calls to `READ` after the restart.
+
+Reduction options are processed in the left-to-right manner.
+
+--disable-compression, --enable-compression, -c
+
+  : These options disable/enable/enable the core compression feature in SBCL. Thus this option is meaningful
+  only on SBCL. Compression is enabled by default.
+  
+--remove-docstrings
+
+  : This option removes all docstrings from all symbols in the entire lisp image.
+  
+--delete-package PKG
+
+  : This option can be specified multiple times. It uninterns the symbols in
+    PACKAGE, calls `makeunbound` and `fmakeunbound` on each symbol
+    and deletes the package. Package names are automatically string-upcase'd.
+    
+--delete-all-packages
+
+  : This option applies --delete-package PKG on all packages, except some
+    blacklisted packages (keyword, roswell, ROS.SCRIPT.DUMP, and the package
+    of the main function symbol).
+
+--delete-packages-except PACKAGE
+
+  : This option can be specified multiple times. It is identical to
+    --delete-all-packages except that it adds PACKAGE to
+    the blacklist. Package names are automatically string-upcase'd.
+
+--destroy-packages-sbcl
+
+  : This is an sbcl-specific option which is even more aggressive than the
+    above methods (>10MB reduction). It destroys the package system by
+    modifying the internal tables for packages, cleaning up the caches for
+    package-use-list etc.  The blacklist is shared among --delete-all-packages
+    and --destroy-packages-sbcl.  However, this method does not call
+    fmakunbound/makunbound, so combining the two methods can result in a more
+    aggressive image size reduction.  Due to the nature of this option, it is
+    desirable to specify it as the last method (i.e. rightmost).
+
+--purify, --no-purify
+
+  : This is common to CCL, SBCL, CMUCL. Moves all objects to the static space
+  where GC does not scan, for the later performance of GC.  Purification is
+  enabled by default.
+
+--impurify, --no-impurify
+
+  : This is an CCL-specific option (enabled by default).
+  It moves all objects to the dynamic space before saving the image.
+  This allows the static-space objects to be GC'ed.
+  When purification is enabled, it impurifies all objects before running the purifying GC.
+
+--delete-debug-info
+
+  : This removes the debug infomation of functions (used to show the stack frame etc),
+    as well as the source locations and the deprecation information of various symbols.
+    SBCL only. This option has a large effect (+10MB reduction).
+
+--delete-macro-definitions, --delete-compiler-macro-definitions
+
+  : This removes all definitions of macros and compiler-macros, assuming that
+    no runtime compilation/interpretation of code will be performed.
+    This option should be portable across implementations.
+    It has ~2MB reduction on SBCL.
+
+--delete-compiler-information-sbcl
+
+  : This is an SBCL-specific option which is more aggressive than the above
+    methods (~4MB reduction). In addition to the macro and the compiler-macro
+    definitions, it destroys the internal compiler systems of SBCL by also
+    removing the inlining information, IR1 transformer and IR2 (VOP).
+  
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_sbcl_(1) _ros_(1) _ros-init_(1)

documents/ros-emacs.md

@@ -0,0 +1,23 @@
+
+ros-emacs - launch Emacs with Slime
+# Synopsis
+
+**ros emacs** [ARGS...]
+
+<!-- # subcommands -->
+
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+# Description
+
+Launches Emacs with a Slime(https://common-lisp.net/project/slime/) buffer opened, which is connected to the back-end lisp implementation of roswell.
+Additional arguments are passed to emacs.
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1), _emacs_(1)

documents/ros-help.md

@@ -0,0 +1,22 @@
+ros-help - Show Command help
+
+# Synopsis
+
+**ros help** [subcommand or topics]
+
+<!-- # subcommands -->
+
+<!-- somecommand -->
+<!-- :description. end with a period. -->
+
+# Description
+
+**ros help** shows description of subcommand or topics
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_sbcl_(1), _ros_(1)
+

documents/ros-init.md

@@ -0,0 +1,60 @@
+ros-init - Create a roswell script (optionally based on a template)
+
+# Synopsis
+
+**ros init [TEMPLATE] NAME [ARGS...]]** 
+
+TEMPLATE
+
+  : Specifies the name of a template, defaulted to *default*
+    template. However, if *TEMPLATE* is not specified and *FILENAME*
+    matches one of the templates being stored, then it automatically uses
+    the template. To suppress this behavior, you should explicitly
+    specify *TEMPLATE* as *default*.
+
+    Thus you are warned when you use this command from a shell script. In
+    order to achieve a consistent and desired behavior, it is adviced that
+    they should always explicitly specify the template name.
+
+NAME
+
+  : Specify the output filename, or "-" to indicate *stdout*. When *TEMPLATE* is *default*, it automatically appends a file type ".ros".
+
+
+<!-- # subcommands -->
+
+# Description
+
+Initialises a roswell file based on a template. User-specified templates can be added by _ros-template_(1).
+
+The default template is something like:
+
+```
+#!/bin/sh
+#|-*- mode:lisp -*-|#
+#| <Put a one-line description here>
+exec ros -Q -- $0 "$@"
+|#
+(progn ;;init forms
+  (ros:ensure-asdf)
+  ;;#+quicklisp (ql:quickload '() :silent t)
+  )
+
+(defpackage :ros.script.test.3703600390
+  (:use :cl))
+(in-package :ros.script.test.3703600390)
+
+(defun main (&rest argv)
+  (declare (ignorable argv)))
+;;; vim: set ft=lisp lisp:
+```
+
+This is basically a shell script which immediately invokes Roswell by exec (see _sh(1)_). Roswell loads the same script as an input, skips multi-line comments, reads the rest of the file as a Common Lisp program, and finally invokes a function main with command-line arguments.
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_sbcl_(1) _ros_(1) _ros-template_(1)
+

documents/ros-install.md

@@ -0,0 +1,80 @@
+ros-install - Install lisp implementations or quicklisp system
+
+# Synopsis
+
+* **ros install** system [system ...]
+* **ros install** impl[/version] [param ...]
+
+# Description
+
+system
+
+  : a name specifying a system.
+
+impl
+
+  : a name specifying a lisp implementation.
+
+<!-- # subcommands -->
+
+# Installing a Lisp Implementation
+
+When the `impl` or `system`  matches to one of the supported implementations, it fetches, downloads and installs it to one of the internal directory managed by roswell (~/.roswell, or `ROSWELL_INSTALL_DIR`). In order to use the installed implementation, you have to run _ros-use(1)_.
+
+For example, the following command downloads the latest sbcl binary from sbcl.org. Note that this may be different from the default binary installed by roswell, called `sbcl-bin`. `sbcl-bin` is a stable and well-tested version of the sbcl binary which is supposed to be a little older than the latest sbcl.
+
+    $ ros install sbcl
+
+When invoked without a name, it prints the list of installable implementations. (Not to be confused with `ros list installed`, which shows the implementations already installed.)
+
+    Usage: ros install impl [OPTIONS]
+
+    For more details on impl specific options, type:
+    ros help install impl
+
+    Candidates impls for installation are:
+    ecl
+    sbcl
+    clisp
+    ccl-bin
+    sbcl-bin
+
+The name can be optionally followed by a slash `/` and a version of the implementation.
+
+    $ ros install sbcl/1.2.14
+
+There might be some _hidden_ implementation that are not listed here --- they are in the alpha quality, but try the one you like or watch the website (https://github.com/roswell/roswell).
+
+    $ ros install ccl
+    $ ros install abcl
+    $ ...
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# Installing a quicklisp system and the bundled roswell scripts
+
+If the specified name does not match any of the implementations, roswell tries to find a quicklisp system of the given name.
+
+    $ ros install alexandria
+
+After compiling and loading the system, it funcalls `ros:*build-hook*` special variable with no argument, if some function is set during the compilation/load.
+
+When the system comes with a **roswell script** created by _ros-init_(1) in the subdirectory `roswell`, they are installed into **ROSWELL_INSTALL_DIR/bin**. Setting the path to this directory makes those scripts available from the shell command line.
+
+    $ ros install qlot
+    System 'qlot' found. Loading the system..
+    Processing build-hook..
+    Found 1 scripts: qlot
+    Attempting to install the scripts in roswell/ subdirectory of the system...
+    /home/user/.roswell/bin/qlot
+
+    $ qlot
+    Usage: qlot [install | update | bundle | exec shell-args..]
+
+
+
+# SEE ALSO
+_sbcl_(1), _ros_(1), _ros-list_(1), _ros-init_(1)
+

documents/ros-list.md

@@ -0,0 +1,39 @@
+ros-list - list the materials installed by roswell
+
+# Synopsis
+
+**ros list [type] [options]**
+
+<!-- # subcommands -->
+
+<!-- somecommand -->
+<!-- :description. end with a period. -->
+
+# Description
+
+**ros list** shows the list of the materials installed by roswell.
+
+installed [ [ IMPL | IMPL/VERSION ]...]
+
+  : List the implementations that have been already installed. Optionally
+  providing IMPL shows the installed versions of the implementation.
+
+dump [IMPL]
+
+  : List the internal dumped images that are compatible with IMPL. When
+  IMPL is ommited, it is defaulted to the current lisp implementation in
+  use. Images are in `$ROSWELL_INSTALL_DIR/impl/.../dump/`.
+
+versions [IMPL]
+
+  : List the installable versions for IMPL. When IMPL is ommited, it is
+  defaulted to the current lisp implementation in use. This feature
+  is experimental.
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_sbcl_(1) _ros_(1)
+

documents/ros-run.md

@@ -0,0 +1,24 @@
+
+ros-run - start a REPL
+# Synopsis
+
+**ros [options] run**
+
+
+<!-- # subcommands -->
+
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+# Description
+
+Processes the given options and start a REPL using the currently effective
+lisp implementation set by _ros-use_(1).
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1)

documents/ros-serve.md

@@ -0,0 +1,31 @@
+ros-serve - start lisp server
+
+# Synopsis
+
+**ros [options for roswell ... ] serve** protocol [options for the protocol ...] ...
+
+<!-- # subcommands -->
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+# description
+
+`ros-serve` start lisp and wait for clients to connect to the lisp.
+
+# swank protocol options
+
+`--port port`
+
+  : Listen port would be `port` instead of the default port 4005.
+
+`--interface interface`
+
+  : limit interface for listen. default is `localhost` so there would be no limitation.
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1) _ros-client_(1)

documents/ros-setup.md

@@ -0,0 +1,27 @@
+ros-setup - setup the backend of roswell
+
+# Synopsis
+
+**ros setup**
+
+<!-- # subcommands -->
+
+<!-- somecommand -->
+<!-- :description. end with a period. -->
+
+# Description
+
+**ros setup** initializes roswell. The process includes the following steps:
+
+* Downloading the default stable lisp implementation (sbcl-bin) to `ROSWELL_INSTALL_DIR`.
+* Installing quicklisp to `ROSWELL_INSTALL_DIR`.
+* On Windows, install 7zip to `ROSWELL_INSTALL_DIR`.
+* Making the core image of roswell itself.
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_sbcl_(1), _ros_(1), section Environmental Variables
+

documents/ros-template.md

@@ -0,0 +1,172 @@
+ros-template - Edit template for ros-init
+
+# synopsis
+
+* **ros template** command args...
+
+# Subcommands
+
+init template-name
+
+  : Create new template in local-project directory.
+
+deinit template-name
+
+  : Remove a template from local-project directory.
+
+list
+
+  : Show file list and states of the files *type* *chmod* *rewrite* in templates.
+
+checkout [template-name]
+
+  :  When invoked without template-name,this command shows candidates for current templates to operate.If with template-name, this command choose the name as current template. 
+
+add [template-name] [files ...]
+
+  : Add files to current template.First parameter could taken as a template-name when current template are *default*.
+
+cat [template-name] [files ...]
+
+  : Show contents in the current template.
+
+edit [template-name] [files ...]
+
+  : Edit content of files in template using `/usr/bin/editor`.
+
+path [template-name] [files ...]
+
+  : Show native path of files in template.
+
+rm [template-name] [files ...]
+
+  : Remove file form current template.
+
+type [template-name] [type] [files ...]
+
+  : Change file type. current choice for *type*s are *djula* or *copy* {{name}} {{author}} {{email}} {{universal_time}} are available variable in the template file. Withoug files, change default type.
+
+chmod [template-name] [mode] [files ...] 
+
+  : Change file mode bits to generate. specify mode in octal format.
+
+rewrite [template-name] file rewrite-rule
+
+  : Change file name using djula template.Variables {{name}} {{author}} {{email}} {{universal_time}} are available for rewrite-rule.
+
+export [template-name] [directory]
+
+  : Export files in current template to current directory.
+
+import [directory]
+
+  : Import template in current directory
+
+help
+
+  : Show the subcommand help.
+
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+# Description
+
+The _ros-template_(1) command manages templates of projects.
+
+## Create template
+
+First, the `init` sub-command creates an empty template.
+
+    $ ros template init sample-template
+
+Many of sub-commands take a template name as first argument. But you can omit it by the `checkout` sub-commands. After the following, such sub-commands are applied to `sample-template`.
+
+    $ ros template checkout sample-template
+
+Next, the `add` sub-command adds local file[s] to template. Then, the `list` sub-command shows information of files in template.
+
+    $ echo "Hello {{ author }}!!" > sample.txt
+    $ ros template add sample.txt
+    $ ros template list
+          copy  sample.txt 
+
+The word *copy* means a strategy when applying the template. There are the following 2 strategies.
+
+- *copy* simply copies the file as-is.
+- *djula* processes the content of the file by template engine, [Djula](http://mmontone.github.io/djula/).
+    - Available variables are explained later.
+
+The `type` sub-command changes it. In addition, default strategy (*copy*) can be changed for each template by the `type` sub-command without file names (Ex. `ros template type djula`).
+
+    $ ros template type djula sample.txt
+    $ ros template list
+          djula sample.txt 
+
+The `sample.txt` will be simply output as `sample.txt` in default. But you can change it by the `rewrite` sub-command. In the following example, it will be output as `sample_<project name>.txt`.
+
+    $ ros template rewrite sample.txt "sample-{{ name }}.txt"
+    $ ros template list
+          djula sample.txt -> "sample-{{ name }}.txt"
+
+Note: Rewrite rules are always processed by Djula irrespective of strategy of the file.
+
+## Apply template
+
+_ros-init_(1) can specify a template.
+
+    $ mkdir temp ; cd temp
+    $ ros init sample-template some-project
+    $ ls
+    sample-some-project.txt
+    $ cat sample-some-project.txt # Assume that "author" is "alien"
+    Hello alien!!
+
+The file name and its content are processed by Djula as explained in the above. The following variables can be used in defaut.
+
+- {{name}}: A project name specified in _ros-init_(1)
+- {{author}}: An author name extracted from config of Git or `whoami`
+- {{email}}: An e-mail address extracted from config of Git or created using `whoami` and `hostname`
+- {{universal_time}}: A universal time created by `get-universal-time` function
+
+In addition, you can use original variables as the followings.
+
+    $ echo "Hello {{ area }}!!" > sample.txt
+    $ ros template add sample.txt # Note: It overwrites existing
+    $ mkdir temp ; cd temp
+    $ ros init sample-template roswell --area 51
+    $ cat sample-roswell.txt
+    Hello 51!!
+
+## Export and import template
+
+Basically, _ros-template_(1) is designed to internally manage added files.
+
+However, if you want to, for example, manage it using Git in a local directory or to install distributed templates, you can use the `export` and `import` sub-commands.
+
+First, the `export` sub-command exports added files and a setting file `roswell.init.<template name>.asd` that is internally created and editted.
+
+    $ ros template export dir
+    $ ls dir
+    roswell.init.sample-template.asd  sample.txt
+    $ cat dir/sample.txt
+    Hello {{ area }}!!
+
+Second, the `import` sub-command imports them.
+
+    # Assume that this is another machine...
+    $ ros template list sample-template # nothing is output 
+    $ ls downloaded
+    roswell.init.sample-template.asd  sample.txt
+    $ ros template import downloaded
+    $ ros template list sample-template
+          djula sample.txt -> "sample-{{ name }}.txt"
+
+Note: If there is a template whose name is same, it will be overwritten.
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1)  _ros-init_(1)

documents/ros-update.md

@@ -0,0 +1,23 @@
+ros-update - Update system installed from vcs
+
+# Synopsis
+
+* **ros update** system [system ...]
+* **ros update** method [params ...]
+
+# Description
+
+system
+
+  : a name specifying a system.
+
+method
+
+  : currently supported method is `git`.
+
+# Update system
+
+When system are already installed and the system has `.git` in the system directory it invoke `git pull` and `ros install` the system.
+
+# SEE ALSO
+_ros_(1), _ros-install_(1)

documents/ros-use.md

@@ -0,0 +1,52 @@
+
+ros-use - sets the default implementation used by roswell
+# synopsis
+
+**ros [options] use** impl[/version]
+
+impl
+    : The name of an implementation which is already installed. New
+    implementations can be downloaded by _ros-install_(1).
+    The list of installed implementations is available in _ros-list_(1).
+
+version:
+    : The version specifier. The string representation of the version
+    (e.g. <major>.<minor>) depends on each implementation and roswell
+    generally follows the representation used by the implementation. In
+    addition, *a special version name "system"* tells roswell to use the
+    implementation that is installed in your system, which should be in PATH.
+
+# example
+
+ros use sbcl
+    : use the latest SBCL among several versions of SBCLs installed by _ros-install_. This is compiled from the source, which may take some time to install but allows SLIME to jump to the implementation source code.
+
+ros use sbcl-bin
+    : use the latest stable SBCL binary downloaded from vendor's website. Roswell uses this by default. `sbcl-bin` tends to be an older version compared to `sbcl`, but surely newer than your _apt-get_ installed counterpart!
+
+ros use sbcl/1.3.1
+    : use the compiled SBCL 1.3.1.
+    
+ros use sbcl-bin/1.3.1
+    : use the prebuilt SBCL 1.3.1.
+
+ros use sbcl/system
+    : use the SBCL available in the PATH.
+
+ros use ccl
+    : use the CCL compiled from the source. Same set of version specifiers as for SBCL can be applied.
+
+Roswell also supports _abcl_, _acl_, _clisp_, _cmu_ and _ecl_.
+
+<!-- # subcommands -->
+
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_sbcl_(1), _ros_(1), _ros-install_(1), _ros-list_(1)

documents/ros-wait.md

@@ -0,0 +1,30 @@
+
+ros-wait - 
+# synopsis
+
+**ros [options] wait**
+
+<!-- # subcommands -->
+
+<!-- somecommand -->
+ 
+<!--   : description. end with a period. -->
+
+# Description
+
+Wait forever after processing the options.
+
+Useful when the application should work as a background/daemonized application.
+
+# Usecase
+
+This loads and launches a clack application and wait for the request from the client.
+
+    $ ros -sp clack -l app.lisp -e '(clack:clackup)' wait
+
+<!-- # options -->
+<!--  -->
+<!-- # Environmental Variables -->
+
+# SEE ALSO
+_ros_(1)