Minor documentation, indentation tweaks

darcs-hash:20061129142102-ac50b-0ae69ec0878a54092f16261b314b34ef4eeeb5ba.gz

complete.c

@@ -1,7 +1,6 @@
-/** \file complete.c
-	Functions related to tab-completion.
+/** \file complete.c Functions related to tab-completion.
 
-	These functions are used for storing and retrieving tab-completion data, as well as for performing tab-completion.
+These functions are used for storing and retrieving tab-completion data, as well as for performing tab-completion.
 */
 #include "config.h"
 
@@ -389,7 +388,7 @@ static void clear_hash_entry( void *key, void *data )
    Search for an exactly matching completion entry
 */
 static complete_entry_t *complete_find_exact_entry( const wchar_t *cmd,
-												  const int cmd_type )
+													const int cmd_type )
 {
 	complete_entry_t *i;
 	for( i=first_entry; i; i=i->next )
@@ -1409,8 +1408,8 @@ static void complete_cmd( const wchar_t *cmd,
 			}
 			
 			if( expand_string( 0,
-						   nxt_completion,
-						   comp,
+							   nxt_completion,
+							   comp,
 							   ACCEPT_INCOMPLETE | DIRECTORIES_ONLY ) != EXPAND_ERROR )
 			{
 				/*

complete.h

@@ -70,7 +70,8 @@
 
   Add a completion. 
 
-  Values are copied and should be freed by the caller.
+  All supplied values are copied, they should be freed by or otherwise
+  disposed by the caller.
 
   Examples: 
   

configure.ac

@@ -339,7 +339,7 @@ fi
 AC_CANONICAL_TARGET
 
 if test $target_cpu = powerpc; then
-   AC_DEFINE([TPUTS_KLUDGE],[1],[Evil kludge to get Power based machines to work])
+	AC_DEFINE([TPUTS_KLUDGE],[1],[Evil kludge to get Power based machines to work])
 fi
 
 

doc_src/index.hdr.in

@@ -1341,16 +1341,16 @@ g++, javac, java, gcj, lpr, doxygen, whois, find)
 - The code validator should warn about unknown commands.
 - Auto-newlines
 - A fault injector could be written to increase robustness and testing of error recovery paths
+- The parser/validator could be more clever in order to make things like writing 'function --help' work as expected
 
 \subsection bugs Known bugs and issues
 
 - Completion for gcc -\#\#\# option doesn't work.
 - Suspending and then resuming pipelines containing a builtin is broken. How should this be handled?
 - The completion pager doesn't work if stderr is redirected.
-- Can't complete directories as commands unless there is a slash - maybe this is a symlink issue?
 - ls should use dircolors
 - delete-word is broken on the commandline 'sudo update-alternatives --config x-'
-- Multiple backslashes at the end of a line is interpreted as not executing, this should only happen for an odd number of backslashes
+- kill highlights signal numbers as errors
 
 If you think you have found a bug not described here, please send a
 report to <a href="mailto:fish-users@lists.sf.net">fish-users@lists.sf.net</a>.