Added documentation for ref plugin
authorMark Szymanski <mrman208@me.com>
Sun, 5 Dec 2010 23:01:19 +0000 (17:01 -0600)
committerMark Szymanski <mrman208@me.com>
Sun, 5 Dec 2010 23:01:19 +0000 (17:01 -0600)
plugins/ref.plugin.bash

index 0c93d70..d5888db 100644 (file)
@@ -1,3 +1,27 @@
+#####################################################################################################################################################################
+# README                                                                                                                                                                                                                                                                                                                       #
+# ------                                                                                                                                                                                                                                                                                                                       #
+#                                                                                                                                                                                                                                                                                                                                      #
+# ref is a plugin for storing HTML formatted references, mainly suited for programming.                                                                                                                                                        #
+# Your $REF_DIR variable is the directory for storing these references in. If it does not exist, it will be created automatically.                                                                     #
+# Here is an example of what my $REF_DIR looks like, because this will be of use when I explain how your $REF_DIR has to be structured:                                                        #
+#                                                                                                                                                                                                                                                                                                                                      #
+# ~/.ref/                                                                                                                                                                                                                                                                                                                      #
+#   ruby/                                                                                                                                                                                                                                                                                                                      #
+#       general/                                                                                                                                                                                                                                                                                                       #
+#                      index.html                                                                                                                                                                                                                                                                                              #
+#      bash/                                                                                                                                                                                                                                                                                                                   #
+#              array/                                                                                                                                                                                                                                                                                                          #
+#                      index.html                                                                                                                                                                                                                                                                                              #
+#              select/                                                                                                                                                                                                                                                                                                         #
+#                      index.html                                                                                                                                                                                                                                                                                              #
+#                                                                                                                                                                                                                                                                                                                                      #
+# This is what the basic structure of your $REF_DIR should look like: Subdirectories for each subject, and then another set of subdirectories for the part of the   #
+# subject you want to reference. And in the second subdirectory, an index.html file.                                                                                                                                                           #
+#                                                                                                                                                                                                                                                                                                                                      #
+# I hope that you like this plugin and if you have any questions about it, send me (mrman208) a message on GitHub or email me at mrman208@me.com                                       #
+#####################################################################################################################################################################
+
 ref() {
        if [ ! -d "$REF_DIR" ]
        then