ifill-paragraph(3)

[Home] [Commands] [Variables] [Macro-Dev] [Glossary]

NAME

ifill-paragraph - Format a paragraph

SYNOPSIS

n ifill-paragraph (esc q)

DESCRIPTION

ifill-paragraph, like fill-paragraph, fills the current paragraph from the left margin to the current fill column. In addition ifill-paragraph also recognizes joined bullet lists and fills each bullet paragraph separately.

See fill-paragraph(2) for more information on the process of filling paragraphs.

EXAMPLE

Following are 2 copies of the same paragraph, the first has been filled using ifill-paragraph:

This  is the  main  paragraph  which  can be as long as  required, 
following is a list of bullets, some with a sub-bullet  list. Here 
is the list: 
    a) The bullet paragraph can also be as long as required and it 
       also can have a bullet  list  following  (sub-bullet  list) 
       which will also be filled correctly. Here is the sub-bullet 
       list: 
       1. First  sub-bullet - again no length  restrictions,  this 
          will be filled correctly. 
       2. second sub-bullet - no problems. 
       3. Third sub-bullet - again no length restrictions, this is 
          getting boring. 
    b) This is the second  major bullet and this can just carry on 
       for ever, but all things must come to an

The following version has been filled using the normal fill-paragraph:

This  is the  main  paragraph  which  can be as long as  required, 
following is a list of bullets, some with a sub-bullet  list. Here 
is the  list:  a) The  bullet  paragraph  can  also  be as long as 
required and it also can have a bullet list following  (sub-bullet 
list) which will also be filled  correctly. Here is the sub-bullet 
list: 1. First  sub-bullet  - again no length  restrictions,  this 
will be filled  correctly. 2. second  sub-bullet - no problems. 3. 
Third sub-bullet - again no length  restrictions,  this is getting 
boring. b) This is the second major bullet and this can just carry 
on for ever, but all things must come to an

NOTES