projects / osl.git / commitdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (from parent 1: abb6ef7)
Convert README and INSTALL to markdown.
authorAndre Noll <maan@tuebingen.mpg.de>
Thu, 21 Apr 2016 09:09:39 +0000 (11:09 +0200)
committerAndre Noll <maan@tuebingen.mpg.de>
Thu, 28 Jul 2016 13:48:16 +0000 (15:48 +0200)
The grutatxt project is dead, so we need to switch to something else
eventually. Fortunately, only little changes are required for the
switch to the markdown markup language as there are only two files in
the source tree which are formated with grutatxt. This patch converts
both files and adjusts the Makefile to run the markdown converter
instead of the grutatxt script.

INSTALL patch | blob | history
Makefile patch | blob | history
README patch | blob | history

diff --git a/INSTALL b/INSTALL
index 7d3c78f77cf7a815012350d4a81fb2f4996a961b..7ead48a0993c3ca407933395d17fa532668ebb29 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -4,18 +4,18 @@ help2man to generate its man page.
 
 If everything mentioned above is available on your system, type
 
-       make
+               make
 
 to build the library, the oslfsck executable and the man page. Then
 type
 
-       make install
-       ldconfig
+               make install
+               ldconfig
 
 as root to install libosl, oslfsck and the man page. The default
 installation prefix is /usr/local. Use
 
-       make install PREFIX=/somewhere/else
+               make install PREFIX=/somewhere/else
 
 to install in /somewhere/else instead.
 
@@ -23,8 +23,8 @@ The make targets in the web/ directory are used for web page generation
 and are not needed to compile, install or use libosl. In order to
 make these targets the following additional tools are needed:
 
-       - http://www.stack.nl/~dimitri/doxygen/ (doxygen)
-       - http://www.triptico.com/software/grutatxt.html (grutatxt)
-       - convert (from the http://www.imagemagick.org/script/index.php (ImageMagick) package)
+- [doxygen](http://www.stack.nl/~dimitri/doxygen/)
+- [discount](http://www.pell.portland.or.us/~orc/Code/discount/)
+- [ImageMagick](http://www.imagemagick.org/script/index.php)
 
 The osl logo was created with Adobe Illustrator by Sebastian Schultheiss.
diff --git a/Makefile b/Makefile
index e37af6acee28852ebd53e9606cee5020a39b64fa..ecd47f44519e8e083fcf82912b5867772298a9e3 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -204,9 +204,9 @@ web/osl.png: web/osl.pdf Makefile
 
 web/index.html: oslfsck.1 web/index.html.in INSTALL README
        sed -e '/@README@/,$$d' web/index.html.in > $@
-       grutatxt -nb < README >> $@
+       markdown < README >> $@
        sed -e '1,/@README@/d' -e '/@INSTALL@/,$$d' web/index.html.in >> $@
-       grutatxt -nb < INSTALL >> $@
+       markdown < INSTALL >> $@
        sed -e '1,/@INSTALL@/d' -e '/@MAN_PAGE@/,$$d' web/index.html.in >> $@
        groff -m man -Thtml -P -l oslfsck.1 | sed -e '1,/^<body>/d; /^<\/body>/,$$d' >> $@
        sed -e '1,/@MAN_PAGE@/d' web/index.html.in >> $@
diff --git a/README b/README
index c8cfff0824f9e76322601ee1fda525ae244a206d..7fa350ada20490977e11e770f3fe0d96b0059b91 100644 (file)
--- a/README
+++ b/README
@@ -6,35 +6,35 @@ system provides.
 
 Libosl is simple:
 
-       - For libosl, all data stored in the osl tables are blobs,
-       libosl will never try to interpret the table contents.
+- For libosl, all data stored in the osl tables are blobs,
+libosl will never try to interpret the table contents.
 
-       - There is no fancy query language but only a relatively
-       simple C-API.
+- There is no fancy query language but only a relatively
+simple C-API.
 
-       - There's no network support for network-access and libosl
-       only uses a very rudimentary table locking mechanism.
+- There's no network support for network-access and libosl
+only uses a very rudimentary table locking mechanism.
 
-       - There are no dependencies on external libraries. An augmented
-       version of the red-black tree implementation of the linux
-       kernel is in included in the libosl package.
+- There are no dependencies on external libraries. An augmented
+version of the red-black tree implementation of the linux
+kernel is in included in the libosl package.
 
 Libosl is fast:
 
-       - It uses sha1 hashes for content-based addressing.
+- It uses sha1 hashes for content-based addressing.
 
-       - Red-black trees are used to make lookups fast.
+- Red-black trees are used to make lookups fast.
 
 Libosl is portable:
 
-       - It is known to compile and run on Linux, MacOS, FreeBSD,
-       NetBSD and Solaris.
+- It is known to compile and run on Linux, MacOS, FreeBSD,
+NetBSD and Solaris.
 
-       - Content and metadata is stored in an endian-agnostic way.
+- Content and metadata is stored in an endian-agnostic way.
 
 Libosl is open source:
 
-       - Licensed under the GPL, version 2.
+- Licensed under the GPL, version 2.
 
 Apart from the library itself, the package also contains simple
 examples and an fsck program, oslfsck, which can be used to recover
osl - the object storage layer