From af11974accc5f483ab828cb16b89e9eafdf0d1f9 Mon Sep 17 00:00:00 2001 From: jozan Date: Fri, 27 Nov 2020 23:57:54 +0000 Subject: Added plain text README FossilOrigin-Name: 7e71bcb6bd74a355ed1114e40b2254b08454260fbf617c13301090fd931397c9 --- README | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++- README.md | 1 + README.org | 2 ++ 3 files changed, 63 insertions(+), 1 deletion(-) 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 . -- cgit v1.2.3