Filling and indentation, please document

Filling and indentation, please document

[Lennart Borgman]

There is a very nice feature of fill-paragraph that let you fill like this:

- This part will be filled
  and indented. Very nice.

But how to you do to make it fill this way? Is it documented? I used
to believe that putting point after "-" at "T" before calling
fill-paragraph made this happen, but that does not seem to be true now
(checked out 2009-12-04). Was I just dreaming that, or?

Re: Filling and indentation, please document

[Robert J. Chassell]

    There is a very nice feature of fill-paragraph that let you fill like this:

    - This part will be filled
      and indented. Very nice.

    But how to you do to make it fill this way? Is it documented? 

See  (emacs)Adaptive Fill
which is part of (emacs)Filling and is called

  29.5.4 Adaptive Filling

Among other things, the documentation says

    ... The decision is complicated because there are three
    reasonable things to do in such a case:

       * Use the first line's prefix on all the lines of the paragraph.

       * Indent subsequent lines with whitespace, so that they line up
         under the text that follows the prefix on the first line, but
         don't actually copy the prefix from the first line.

       * Don't do anything special with the second and following lines.

       All three of these styles of formatting are commonly used.  So the
    fill commands try to determine what you would like, based on the prefix
    that appears and on the major mode.

-- 
    Robert J. Chassell                          
    bob@gnu.org                                 bob@rattlesnake.com
    http://www.rattlesnake.com                  http://www.teak.cc

RE: Filling and indentation, please document

[Drew Adams]

> There is a very nice feature of fill-paragraph that let you 
> fill like this:
> 
> - This part will be filled
>   and indented. Very nice.
> 
> But how to you do to make it fill this way? Is it documented? I used
> to believe that putting point after "-" at "T" before calling
> fill-paragraph made this happen, but that does not seem to be true now
> (checked out 2009-12-04). Was I just dreaming that, or?

Dunno if this is what you're talking about, and without reference to the latest
Emacs, it has been the case that if you have point on the second line, not the
first, and the second line is indented as you show, then hitting M-q indents
subsequent lines similarly.