00dani/stow
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Improve existing comments.

Browse source
This commit is contained in:
Adam Spiers 2012-01-09 16:25:27 +00:00
parent 782836bad7
commit 1efb786140
1 changed files with 9 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
lib/Stow.pm.in
View file

@ -198,8 +198,8 @@ sub init_state {
# $self->{tasks}: list of operations to be performed (in order) # $self->{tasks}: list of operations to be performed (in order)
# each element is a hash ref of the form # each element is a hash ref of the form
# { # {
# action => ... # action => ... ('create' or 'remove')
# type => ... # type => ... ('link' or 'dir')
# path => ... (unique) # path => ... (unique)
# source => ... (only for links) # source => ... (only for links)
# } # }
@ -823,7 +823,7 @@ sub unstow_node {
#===== METHOD =============================================================== #===== METHOD ===============================================================
# Name : path_owned_by_package() # Name : path_owned_by_package()
# Purpose : determine if the given link points to a member of a # Purpose : determine whether the given link points to a member of a
# : stowed package # : stowed package
# Parameters: $target => path to a symbolic link under current directory # Parameters: $target => path to a symbolic link under current directory
# : $source => where that link points to # : $source => where that link points to
@ -842,7 +842,7 @@ sub path_owned_by_package {
#===== METHOD =============================================================== #===== METHOD ===============================================================
# Name : find_stowed_path() # Name : find_stowed_path()
# Purpose : determine if the given link points to a member of a # Purpose : determine whether the given link points to a member of a
# : stowed package # : stowed package
# Parameters: $target => path to a symbolic link under current directory # Parameters: $target => path to a symbolic link under current directory
# : $source => where that link points to (needed because link # : $source => where that link points to (needed because link
@ -962,7 +962,7 @@ sub cleanup_invalid_links {
#===== METHOD =============================================================== #===== METHOD ===============================================================
# Name : foldable() # Name : foldable()
# Purpose : determine if a tree can be folded # Purpose : determine whether a tree can be folded
# Parameters: $target => path to a directory # Parameters: $target => path to a directory
# Returns : path to the parent dir iff the tree can be safely folded # Returns : path to the parent dir iff the tree can be safely folded
# Throws : n/a # Throws : n/a
@ -1496,7 +1496,7 @@ sub dir_task_action {
#===== METHOD =============================================================== #===== METHOD ===============================================================
# Name : parent_link_scheduled_for_removal() # Name : parent_link_scheduled_for_removal()
# Purpose : determines whether the given path or any parent thereof # Purpose : determine whether the given path or any parent thereof
# : is a link scheduled for removal # : is a link scheduled for removal
# Parameters: $path # Parameters: $path
# Returns : Boolean # Returns : Boolean
@ -1524,7 +1524,7 @@ sub parent_link_scheduled_for_removal {
#===== METHOD =============================================================== #===== METHOD ===============================================================
# Name : is_a_link() # Name : is_a_link()
# Purpose : is the given path a current or planned link # Purpose : determine if the given path is a current or planned link
# Parameters: $path # Parameters: $path
# Returns : Boolean # Returns : Boolean
# Throws : none # Throws : none
@ -1558,7 +1558,7 @@ sub is_a_link {
#===== METHOD =============================================================== #===== METHOD ===============================================================
# Name : is_a_dir() # Name : is_a_dir()
# Purpose : is the given path a current or planned directory # Purpose : determine if the given path is a current or planned directory
# Parameters: $path # Parameters: $path
# Returns : Boolean # Returns : Boolean
# Throws : none # Throws : none
@ -1593,7 +1593,7 @@ sub is_a_dir {
#===== METHOD =============================================================== #===== METHOD ===============================================================
# Name : is_a_node() # Name : is_a_node()
# Purpose : is the given path a current or planned node # Purpose : determine whether the given path is a current or planned node
# Parameters: $path # Parameters: $path
# Returns : Boolean # Returns : Boolean
# Throws : none # Throws : none