Documentation

Documentation

[Eli Zaretskii]

What's the plan for updating the documentation for Emacs 23?

So many new and improved features are in dire need of documenting
them, and so few people actually contribute to the manuals, that I
have a hard time believing we'll be done by the pretest.  IIRC, just
reviewing the manuals, _after_ they were already updated, was a
formidable job that took quite a few weeks.

I suggest we start this ASAP.

Re: Documentation

[Chong Yidong]

Eli Zaretskii <eliz@gnu.org> writes:

> What's the plan for updating the documentation for Emacs 23?
>
> So many new and improved features are in dire need of documenting
> them, and so few people actually contribute to the manuals, that I
> have a hard time believing we'll be done by the pretest.  IIRC, just
> reviewing the manuals, _after_ they were already updated, was a
> formidable job that took quite a few weeks.
>
> I suggest we start this ASAP.

If anyone would like to volunteer, please email me.

Re: Documentation

[Alfred M. Szmidt]

Don't forget the NEWS file, seems that there are quite huge changes
that have not been noted there.  For example, I opned a .pdf file
today, and to my suprise I was welcomed not by gibberish, but by an
PNG file rendered in splendid colour!

Re: Documentation

[Eli Zaretskii]

> CC: emacs-devel@gnu.org
> From: "Alfred M. Szmidt" <ams@gnu.org>
> Date: Sat, 11 Oct 2008 16:05:48 -0400
> 
> Don't forget the NEWS file, seems that there are quite huge changes
> that have not been noted there.  For example, I opned a .pdf file
> today, and to my suprise I was welcomed not by gibberish, but by an
> PNG file rendered in splendid colour!

The only way of making sure this isn't forgot is to add to NEWS an
item that mentions the change.

Re: Documentation

[Chong Yidong]

"Alfred M. Szmidt" <ams@gnu.org> writes:

> Don't forget the NEWS file, seems that there are quite huge changes
> that have not been noted there.  For example, I opned a .pdf file
> today, and to my suprise I was welcomed not by gibberish, but by an
> PNG file rendered in splendid colour!

This is already in NEWS:

  ** Doc View Mode allows viewing of PDF, PostScript and DVI documents.
  One can also search for a regular expression in the document.  For
  details, see the commentary in doc-view.el.

This didn't mention that Doc View mode is used by default now for PS,
PDF, and DVI files.  I just added a note to that effect.

Re: Documentation

[Stefan Monnier]

> This didn't mention that Doc View mode is used by default now for PS,
> PDF, and DVI files.  I just added a note to that effect.

IIRC for PS files, it's not activated by default.  You get into
a postscript-mode instead, with a special binding that allows you to
toggle between postscript-mode and doc-view-mode.


        Stefan

Re: Documentation

[Chong Yidong]

Stefan Monnier <monnier@iro.umontreal.ca> writes:

>> This didn't mention that Doc View mode is used by default now for PS,
>> PDF, and DVI files.  I just added a note to that effect.
>
> IIRC for PS files, it's not activated by default.  You get into
> a postscript-mode instead, with a special binding that allows you to
> toggle between postscript-mode and doc-view-mode.

I've made a correction.  Thanks.

Re: Documentation

[Alfred M. Szmidt]

   This is already in NEWS:

I must have missed that, I looked for PNG and docview, but not Dov
View or PDF...  And I did scroll through the whole file... 

     ** Doc View Mode allows viewing of PDF, PostScript and DVI documents.
     One can also search for a regular expression in the document.  For
     details, see the commentary in doc-view.el.

   This didn't mention that Doc View mode is used by default now for PS,
   PDF, and DVI files.  I just added a note to that effect.

Thank you.