comparison man/lispref/files.texi @ 373:6240c7796c7a r21-2b2

Import from CVS: tag r21-2b2
author cvs
date Mon, 13 Aug 2007 11:04:06 +0200
parents c9fe270a4101
children
comparison
equal deleted inserted replaced
372:49e1ed2d7ed8 373:6240c7796c7a
1238 is different from its name as a file. 1238 is different from its name as a file.
1239 * Relative File Names:: Some file names are relative to a current directory. 1239 * Relative File Names:: Some file names are relative to a current directory.
1240 * File Name Expansion:: Converting relative file names to absolute ones. 1240 * File Name Expansion:: Converting relative file names to absolute ones.
1241 * Unique File Names:: Generating names for temporary files. 1241 * Unique File Names:: Generating names for temporary files.
1242 * File Name Completion:: Finding the completions for a given file name. 1242 * File Name Completion:: Finding the completions for a given file name.
1243 * User Name Completion:: Finding the completions for a given user name.
1243 @end menu 1244 @end menu
1244 1245
1245 @node File Name Components 1246 @node File Name Components
1246 @subsection File Name Components 1247 @subsection File Name Components
1247 @cindex directory part (of file name) 1248 @cindex directory part (of file name)
1760 completion-ignored-extensions 1761 completion-ignored-extensions
1761 @result{} (".o" ".elc" "~" ".dvi") 1762 @result{} (".o" ".elc" "~" ".dvi")
1762 @end group 1763 @end group
1763 @end example 1764 @end example
1764 @end defopt 1765 @end defopt
1766
1767 @node User Name Completion
1768 @subsection User Name Completion
1769 @cindex user name completion subroutines
1770 @cindex completion, user name
1771
1772 This section describes low-level subroutines for completing a user
1773 name. For other completion functions, see @ref{Completion}.
1774
1775 @defun user-name-all-completions partial-username
1776 This function returns a list of all possible completions for a user
1777 whose name starts with @var{partial-username}. The order of the
1778 completions is unpredictable and conveys no useful information.
1779
1780 The argument @var{partial-username} must be a partial user name
1781 containing no tilde character and no slash.
1782 @end defun
1783
1784 @defun user-name-completion username
1785 This function completes the user name @var{username}. It returns the
1786 longest prefix common to all user names that start with @var{username}.
1787
1788 If only one match exists and @var{username} matches it exactly, the
1789 function returns @code{t}. The function returns @code{nil} if no user
1790 name starting with @var{username} exists.
1791 @end defun
1792
1793 @defun user-name-completion-1 username
1794 This function completes the user name @var{username}, like
1795 @code{user-name-completion}, differing only in the return value.
1796 This function returns the cons of the completion returned by
1797 @code{user-name-completion}, and a boolean indicating whether that
1798 completion was unique.
1799 @end defun
1800
1765 1801
1766 @node Contents of Directories 1802 @node Contents of Directories
1767 @section Contents of Directories 1803 @section Contents of Directories
1768 @cindex directory-oriented functions 1804 @cindex directory-oriented functions
1769 @cindex file names in directory 1805 @cindex file names in directory