Re: [Boost-bugs] [Boost C++ Libraries] #3793: quickbook should allow indentation

Subject: Re: [Boost-bugs] [Boost C++ Libraries] #3793: quickbook should allow indentation
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2009-12-27 15:26:57

#3793: quickbook should allow indentation
-------------------------------+--------------------------------------------
  Reporter:  anonymous         |       Owner:  djowel   
      Type:  Feature Requests  |      Status:  closed   
 Milestone:  Boost 1.42.0      |   Component:  quickbook
   Version:  Boost 1.41.0      |    Severity:  Problem  
Resolution:  wontfix           |    Keywords:           
-------------------------------+--------------------------------------------
Changes (by danieljames):

  * status:  reopened => closed
  * resolution:  => wontfix

Comment:

 We normally structure large documents by splitting them into several
 files, which I've found very effective, especially with respect to
 tracking changes in version control.

 Many wiki style markup languages use indentation for either blockquotes
 (eg. restructured text and trac) or code blocks (eg. markdown and
 quickbook) so we're not doing anything unusual here. As far as I can tell
 the consensus is against using indentation in this way, for example, users
 of structured text
 [http://docutils.sourceforge.net/docs/dev/rst/problems.html#section-

 structure-via-indentation found it unnatural].

 Please don't reopen this ticket. If you want to discuss the issue further
 the documentation mailing list is the correct forum, as it'll be read by
 other users. But even if it this is considered desirable, we can't change
 the semantics of indentation until a major reworking of the quickbook
 syntax (maybe quickbok 2.0?) which we don't have any plans for in the
 short or long term.

-- 
Ticket URL: <https://svn.boost.org/trac/boost/ticket/3793#comment:3>
Boost C++ Libraries <http://www.boost.org/>
Boost provides free peer-reviewed portable C++ source libraries.