diff --git a/tren.rst b/tren.rst index dbcdac6..f319a6b 100644 --- a/tren.rst +++ b/tren.rst @@ -1590,47 +1590,85 @@ General Attribute Renaming Tokens ================================= + +NOTE TO WINDOWS USERS GOES HERE + + These tokens are derived from information about the file or directory being renamed. -``/DEV/ What This Is`` +``/DEV/ Returns File- Or Directory's Device ID`` + + This is the ID of the device containing the file being renamed. + You might want to rename files so that all the files on a given + device start with the same key. That way, their names group + together in a directory listing:: + + tren.py -r=/DEV/-/FNAME/ file | dir, file | dir, ... + + You end up with a directory listing that looks something like:: + + 93-... + 93-... + 97-... + 98-... + + The filenames are still preserved in our renaming reqest above, + now they're just preceded by the device ID of the where they live + with a trailing ``-`` separator. + +``/FNAME/ Returns Original File- Or Directory Name`` + + This is the name of the file- or directory you are + renaming *before* you apply any renaming requests. This + allows you to create new names based, in part, on the old + name:: + + tren.py -r=/FNAME/-suffix file | dir ... # Adds "-suffix" to the end of original name + tren.py -r=prefix-/FNAME/ file | dir ... # Adds "-prefix" to start of original name + tren.py -r /FNAME/=newname file | dir ... # Same as "-r=newname" + tren.py -r /FNAME/=/FNAME/ file | dir ... # Does nothing since old- and newname are the same + +``/GID/ Returns File- Or Directory's Group ID`` + + This is the number for the group to which the file- or + directory belongs. One way to use this is to prepend it + to every file name, thereby having all files (and or + directories) in the same group sort together in a + directory listing:: + + tren.py -r=/GID/-/FNAME/ file | dir ... + +``/GROUP/ Returns File- Or Directory's Group Name`` + + Essentially the same as ``/GID/`` except it returns the + *name* of the group rather than the number. Again, this + is useful when clustering names together in a directory listing:: + + tren.py -r=/GROUP/-/FNAME/ file | dir ... + +``/INODE/ Returns File- Or Directory's`` Explanation -``/FNAME/ What This Is`` +``/MODE/ Returns File- Or Directory's`` Explanation -``/GID/ What This Is`` +``/NLINK/ Returns File- Or Directory's`` Explanation -``/GROUP/ What This Is`` +``/SIZE/ Returns File- Or Directory's`` Explanation -``/INODE/ What This Is`` +``/UID/ Returns File- Or Directory's`` Explanation -``/MODE/ What This Is`` - - Explanation - -``/NLINK/ What This Is`` - - Explanation - -``/SIZE/ What This Is`` - - Explanation - -``/UID/ What This Is`` - - Explanation - -``/USER/ What This Is`` +``/USER/ Returns File- Or Directory's`` Explanation @@ -1666,35 +1704,35 @@ above is used to compute the value: -``/ADAY/, /CDAY/, /MDAY/ What This Is`` +``/ADAY/, /CDAY/, /MDAY/ Returns File- Or Directory's`` Explanation -``/AHOUR, /CHOUR/, /MHOUR/ What This Is`` +``/AHOUR, /CHOUR/, /MHOUR/ Returns File- Or Directory's`` Explanation -``/AMIN/, /CMIN/, /MMIN/ What This Is`` +``/AMIN/, /CMIN/, /MMIN/ Returns File- Or Directory's`` Explanation -``/AMON/, /CMON/, /MMON/ What This Is`` +``/AMON/, /CMON/, /MMON/ Returns File- Or Directory's`` Explanation -``/AMONT, /CMONTH/, /MMONTH/ What This Is`` +``/AMONT, /CMONTH/, /MMONTH/ Returns File- Or Directory's`` Explanation -``/ASEC/, /CSEC/, /MSEC/ What This Is`` +``/ASEC/, /CSEC/, /MSEC/ Returns File- Or Directory's`` Explanation -``/AWDAY, /CWDAY/, /MWDAY/ What This Is`` +``/AWDAY, /CWDAY/, /MWDAY/ Returns File- Or Directory's`` Explanation -``/AYEAR, /CYEAR/, /MYEAR/ What This Is`` +``/AYEAR, /CYEAR/, /MYEAR/ Returns File- Or Directory's`` Explanation @@ -2025,6 +2063,8 @@ - Literal String Replacement +- Replacing Or Removing All Instances Of A String + - Changing A File's "Extension" Suffix - Appending- Or Prepending Strings To An Existing File Name @@ -2103,7 +2143,7 @@ :: - $Id: tren.rst,v 1.170 2010/04/02 03:17:54 tundra Exp $ + $Id: tren.rst,v 1.171 2010/04/02 20:29:45 tundra Exp $ You can find the latest version of this program at: