bug in documentation [wishlist]

bug in documentation [wishlist]

[Giovanni Ridolfi]

[-- Attachment #1: Type: text/plain, Size: 1575 bytes --]

Hello Carsten, hello everyone,

Thank you everyone for that wonderful piece of sofware that is org-mode,
Thanks for its nice documentation.
However I have a wishlist (and perhaps pedantic ;-) bug concerning the 
documentation itself.
I began to use emacs in order to use outline mode with org-mode...
so I was a completely newbie of lisp and emacs. I spent a day surfing
the net looking for the meaning of "byte-compile org-mode.el" :-/  ((-:  
So I feel that some part should be written in a more explicit way, to be
useful for newbies.

Please see the patch attached.

Furthermore a week ago Crasten announced that org-mouse.el is now part 
of org-mode...
> on 2006-11-01 09:35:22 GMT
> org-mouse.el is now part of the org-mode distribution.
>   Thanks to Piotr Zielinski for this fantastic contribution.  The
>   latest
>   additons and bug fixes will likely still be available from Piotr
>   directly, but from this point on I will include the latest version
>   with the Org-mode distribution.

....so ther is another bug in the documentation:
org-mouse.el is not anymore a third party extension  :-) 
-----------------------------------------------
@node Extensions, Dynamic blocks, Extensions and Hacking, Extensions and
Hacking
@section Third-party extensions for Org-mode

The following extensions for Org-mode have been written by other people:

@table @asis
@cindex @file{org-mouse.el}
@item @file{org-mouse.el} by Piotr Zielinski
This package implements extended mouse functionality for Org-mode.  It
------------------------------------------

Cheers,

Giovanni

[-- Attachment #2: documentation.patch --]
[-- Type: text/plain, Size: 1281 bytes --]

--- org.texi	2006-11-07 14:41:23.000000000 +0100
+++ org.texi	2006-11-07 14:56:28.000000000 +0100
@@ -385,7 +385,9 @@ command:}
 @b{make install-noutline}
 @end example
 
-@noindent Now byte-compile and install the Lisp files with the shell
+@noindent Now byte-compile  -to learn how to byte-compile
+please (@kbd{C-h a byte-compile @key{RET}})-
+and install the Lisp files with the shell
 commands:
 
 @example
@@ -794,7 +796,7 @@ The default archive location is a file i
 current file, with the name derived by appending @file{_archive} to the
 current file name.  For information and examples on how to change this,
 see the documentation string of the variable
-@code{org-archive-location}.
+@code{org-archive-location} (@kbd{C-h v org-archive-location @key{RET}}).
 
 @node Sparse trees, Plain lists, Archiving, Document structure
 @section Sparse trees
@@ -1018,6 +1020,11 @@ with @kbd{@key{TAB}}, @kbd{S-@key{TAB}} 
 field is automatically made blank.  If this behavior is too
 unpredictable for you, configure the variables
 @code{org-enable-table-editor} and @code{org-table-auto-blank-field}.
+To configure the variable insert in your .emacs:
+
+@lisp
+(setq org-enable-table-editor t) ;; hey is it right?
+@end lisp
 
 @table @kbd
 @tsubheading{Creation and conversion}

[-- Attachment #3: Type: text/plain, Size: 149 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode