Remove redundant comments from the .zsh file (since they're in README now).

This commit is contained in:
Andrew Janke 2015-07-15 17:16:59 -04:00
parent 6d618ef70e
commit 9a397254da
1 changed files with 1 additions and 65 deletions

View File

@ -2,71 +2,7 @@
#
# Makes emoji support available within ZSH
#
# This plugin provides support for working with emoji characters in zsh using human-readable
# identifiers. It provides global variables which map emoji names to the actual
# characters, and some anmed groupings of emoji. It also provides associated functions
# for displaying them.
#
# Global variables:
# $emoji - Maps emoji names to characters
# $emoji2 - Auxiliary and combining characters
# $emoji_flags - Maps country names to flag characters (using region-indicators)
# $emoji_skintone - Skin tone modifiers (from Unicode 8.0)
# $emoji_groups - Named groups of emoji. Keys are group names; values are whitespace-separated
# lists of character names
#
# Functions:
# random_emoji - Prints a random emoji character
# display_emoji - Displays emoji, along with their names
#
# The emoji names and codes are sourced from Unicode Technical Report #51, which provides
# information on emoji support in Unicode. It can be found at http://www.unicode.org/reports/tr51/index.html.
#
# The group definitions are added by this OMZ plugin. They are not based on external definitions.
#
# The emoji in the main $emoji map are standalone character sequences which can all be output on their
# own, without worrying about combining effects. The values may actually be multi-code-point sequences,
# instead of a single code point, and may include combining characters in those sequences. But they're
# arranged so their effects do not extend beyond that sequence.
#
# Usage and Examples:
#
# To output a specific emoji, use:
# $> echo $emoji[<name>]
# E.g.:
# $> echo $emoji[mouse_face]
#
# To output a random emoji, use:
# $> random_emoji
# To output a random emoji from a particular group, use:
# $> random_emoji <group>
# E.g.:
# $> random_emoji fruits
# $> random_emoji animals
# $> random_emoji vehicles
# $> random_emoji faces
# The valid group names can be found with `echo ${(k)emoji_groups}`
#
# To list all available emoji with their names, use:
# $> display_emoji
# $> display_emoji fruits
# $> display_emoji animals
# $> display_emoji vehicles
# $> display_emoji faces
#
# To use emoji in a prompt:
# PROMPT="$emoji[penguin] > ""
# PROMPT='$(random_emoji fruits) > '
# surfer=$emoji[surfer]
# PROMPT="$surfer > "
#
#
# TODO: Move doco to a README
# TODO: Factor out parsing from generation in update_emoji.pl
# TODO: Incorporate CLDR data for ordering and groupings
# TODO: Short :bracket: style names (from gemoji)
# TODO: Country codes for flags
# TODO: ZWJ combining function?
# See the README for documentation.
_omz_emoji_plugin_dir="${0:h}"