aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--README61
-rw-r--r--README.md1
-rw-r--r--README.org2
3 files changed, 63 insertions, 1 deletions
diff --git a/README b/README
index f99a926..6a64eb4 100644
--- a/README
+++ b/README
@@ -1 +1,60 @@
-Retest.
+unixize
+-------
+
+unixize is a small tool to bulk rename files into a cool UNIX-friendly
+standard. Basically, everything becomes lowercase and there is no need to
+escape characters anymore when entering your filenames in a terminal. It
+also removes unicode characters.
+
+unixize is configurable through options. Refer to
+ $ man unixize
+to get a list of options.
+
+Dependencies
+------------
+- A C compiler
+- GNU Make
+
+Installation
+------------
+You can get unixize either through git or fossil.
+
+For fossil use:
+ $ mkdir unixize
+ $ cd unixize
+ $ fossil clone https://chiselapp.com/user/JozanLeClerc/repository/unixize unixize.fossil
+ $ fossil open --force unixize.fossil
+
+or for git:
+ $ git clone git://jozanleclerc.xyz/jozan/unixize.git
+ $ cd unixize
+
+Then build the program:
+ $ make
+ $ sudo make install clean
+
+Note that on BSD systems you want to use gmake instead of make:
+ $ gmake
+ $ sudo gmake install clean
+
+Usage
+-----
+USE WITH CAUTION!
+
+Without the -p option, unixize will commit to do exactly
+what it's supposed to do, rename all the badly formatted in the chosen
+directory. To deunixize your files, you'll have to rename everything
+manually.
+
+Example of usage:
+ $ cd messy_directory
+ $ unixize -v -r .
+
+End note
+--------
+Please note that unixize was tested only on FreeBSD at the moment.
+Linux and macOS tests are coming soon. You can report bug on
+[[https://github.com/JozanLeClerc/unixize.git][GitHub]].
+
+Thanks for checking *unixize*.
+
diff --git a/README.md b/README.md
index 79709f2..bcb5b86 100644
--- a/README.md
+++ b/README.md
@@ -76,6 +76,7 @@ what it's supposed to do, rename all the badly formatted in the chosen
directory. To deunixize your files, you'll have to rename everything
manually.
+Example of usage:
```sh
cd messy_directory
unixize -v -r .
diff --git a/README.org b/README.org
index 75308ad..2ee7c11 100644
--- a/README.org
+++ b/README.org
@@ -48,6 +48,8 @@ Without the ~-p~ option, *unixize* will commit to do exactly
what it's supposed to do, rename all the badly formatted in the chosen
directory. To deunixize your files, you'll have to rename everything
manually.
+
+Example of usage:
#+BEGIN_SRC shell
cd messy_directory
unixize -v -r .