aboutsummaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
authorMiquel Sabaté Solà <msabate@suse.com>2020-03-17 17:24:58 +0100
committerMiquel Sabaté Solà <msabate@suse.com>2020-03-17 17:28:22 +0100
commitecdc723c96e0a92fdda3a754edb0302cdc2de9eb (patch)
tree96be54346acd262286a47fbda5b8781f95565190 /README.org
parentda5b6722c9402aa26cda174ecddfc5e2a76985f6 (diff)
downloadg-ecdc723c96e0a92fdda3a754edb0302cdc2de9eb.tar.gz
g-ecdc723c96e0a92fdda3a754edb0302cdc2de9eb.zip
Rebumped the whole project so it's better looking
I've also added the `git-validation` tool into the test suite. Signed-off-by: Miquel Sabaté Solà <msabate@suse.com>
Diffstat (limited to 'README.org')
-rw-r--r--README.org67
1 files changed, 67 insertions, 0 deletions
diff --git a/README.org b/README.org
new file mode 100644
index 0000000..78198fb
--- /dev/null
+++ b/README.org
@@ -0,0 +1,67 @@
+* Yeah! just one letter !
+[[https://travis-ci.org/mssola/g][https://travis-ci.org/mssola/g.svg?branch=master]]
+
+This repository holds a very humble and simple script that handles shortcuts of
+bash paths. For example:
+
+#+BEGIN_SRC bash
+$ g awesome
+# instead of ...
+$ cd /home/user/directory/dir/awesome
+#+END_SRC
+
+Furthermore, this repo also brings a file that adds bash completion so the user
+can access the desired directory as fast as possible. In order to manage
+shortcuts, this script accepts three commands:
+
+#+BEGIN_SRC bash
+$ g add awesome /home/user/directory/dir/awesome
+$ g list
+# Output:
+# awesome => /home/user/directory/dir/awesome
+$ cd /home/user/directory/anotherawesome
+$ g add anotherawesomedir
+$ g rm awesome
+$ g list
+# Output:
+# anotherawesome => /home/user/directory/anotherawesome
+#+END_SRC
+
+I guess that the commands above are quite self-explanatory.
+
+** Install
+
+Just place the =g.sh= and the =gcompletion.sh= files wherever you want and then
+add a =source= command for both of the files in the =.bashrc= file.
+
+** GNU Emacs
+
+I have also created a package for GNU Emacs and it is available on my [[https://github.com/mssola/dotfiles/blob/master/.emacs.d/lisp/g.el][dotfiles]]
+project.
+
+** Contributing
+
+Read the [[./CONTRIBUTING.org][CONTRIBUTING.org]] file.
+
+** [[https://pbs.twimg.com/media/DJDYCcLXcAA_eIo?format=jpg&name=small][Changelog]]
+
+Read the [[./CHANGELOG.org][CHANGELOG.org]] file.
+
+** Legal stuff
+
+#+BEGIN_SRC text
+Copyright (C) 2013-2020 Miquel Sabaté Solà <mikisabate@gmail.com>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>.
+#+END_SRC