+ /// Convert the paragraphs to a string.
+ /// \param AsStringParameter options. This can contain any combination of
+ /// asStringParameter values. Valid examples:
+ /// asString(AS_STR_LABEL)
+ /// asString(AS_STR_LABEL | AS_STR_INSETS)
+ /// asString(AS_STR_INSETS)
+ docstring asString(int options = AS_STR_NONE) const;
+ ///
+ docstring asString(pit_type beg, pit_type end,
+ int options = AS_STR_NONE) const;
+ /// Appends a possibly abbreviated representation of our text
+ /// to \param os, where \param maxlen defines the maximum size
+ /// of \param os. If \param shorten is true, then we will shorten
+ /// \param os to maxlen chars and replace the final three by "...,
+ /// if \param os is longer than maxlen chars.
+ /// if \param maxlen is passed as 0, then it is ignored. (In fact,
+ /// it is reset to the maximum value for size_t.)
+ void forToc(docstring & os, size_t maxlen, bool shorten = true) const;
+