+enum FontTypes {
+ // ranges
+ FT_EMPH,
+ FT_NOUN,
+ FT_UBAR,
+ FT_DBAR,
+ FT_WAVE,
+ FT_SOUT,
+ // bold
+ FT_BOLD,
+ // shapes
+ FT_UPRIGHT,
+ FT_ITALIC,
+ FT_SLANTED,
+ FT_SMALLCAPS,
+ // families
+ FT_ROMAN,
+ FT_SANS,
+ FT_TYPE,
+ // sizes
+ FT_SIZE_TINY,
+ FT_SIZE_SCRIPT,
+ FT_SIZE_FOOTNOTE,
+ FT_SIZE_SMALL,
+ FT_SIZE_NORMAL,
+ FT_SIZE_LARGE,
+ FT_SIZE_LARGER,
+ FT_SIZE_LARGEST,
+ FT_SIZE_HUGE,
+ FT_SIZE_HUGER,
+ FT_SIZE_INCREASE,
+ FT_SIZE_DECREASE
+};
+
+
+///
+struct FontTag : public StartTag
+{
+ ///
+ explicit FontTag(FontTypes type);
+ ///
+ FontTag const * asFontTag() const { return this; }
+ ///
+ bool operator==(StartTag const &) const;
+ ///
+ FontTypes font_type_;
+};
+
+
+///
+struct EndFontTag : public EndTag
+{
+ ///
+ explicit EndFontTag(FontTypes type);
+ ///
+ EndFontTag const * asFontTag() const { return this; }
+ ///
+ FontTypes font_type_;
+};
+
+
+// trivial struct for output of newlines
+struct CR{};
+
+} // namespace html
+
+class XHTMLStream {
+public:
+ ///
+ explicit XHTMLStream(odocstream & os);
+ ///
+ odocstream & os() { return os_; }
+ ///
+ // int & tab() { return tab_; }
+ /// closes any font tags that are eligible to be closed,
+ /// i.e., last on the tag_stack_.
+ /// \return false if there are open font tags we could not close.
+ /// because they are "blocked" by open non-font tags on the stack.
+ bool closeFontTags();
+ /// sets a mark so we know what tags to close at the end.
+ /// normally called at the start of a paragraph.
+ void startDivision(bool keep_empty);
+ /// clears the mark set by previous method.
+ /// there should not be any other tags open before it on the stack,
+ /// but if there are, we will close them.
+ void endDivision();
+ ///
+ XHTMLStream & operator<<(docstring const &);
+ ///
+ XHTMLStream & operator<<(const char *);
+ ///
+ XHTMLStream & operator<<(char_type);
+ ///
+ XHTMLStream & operator<<(int);
+ ///
+ XHTMLStream & operator<<(char);
+ ///
+ XHTMLStream & operator<<(html::StartTag const &);
+ ///
+ XHTMLStream & operator<<(html::EndTag const &);
+ ///
+ XHTMLStream & operator<<(html::CompTag const &);
+ ///
+ XHTMLStream & operator<<(html::ParTag const &);
+ ///
+ XHTMLStream & operator<<(html::FontTag const &);
+ ///
+ XHTMLStream & operator<<(html::CR const &);
+ ///
+ enum EscapeSettings {
+ ESCAPE_NONE,
+ ESCAPE_AND, // meaning &
+ ESCAPE_ALL // meaning <, >, &, at present
+ };
+ /// Sets what we are going to escape on the NEXT write.
+ /// Everything is reset for the next time.
+ XHTMLStream & operator<<(EscapeSettings);
+ /// This routine is for debugging the tag stack, etc. Code
+ /// for it is disabled by default, however, so you will need
+ /// to enable it if you want to use it.
+ void dumpTagStack(std::string const & msg);
+private:
+ ///
+ void clearTagDeque();
+ ///
+ bool isTagOpen(html::StartTag const &) const;
+ ///
+ bool isTagOpen(html::EndTag const &) const;
+ ///
+ bool isTagPending(html::StartTag const &) const;
+ ///
+ void writeError(std::string const &) const;
+ ///
+ odocstream & os_;
+ ///
+ EscapeSettings escape_;
+ // What we would really like to do here is simply use a
+ // deque<StartTag>. But we want to store both StartTags and
+ // sub-classes thereof on this stack, which means we run into the
+ // so-called polymorphic class problem with the STL. We therefore have
+ // to use a deque<StartTag *>, which leads to the question who will
+ // own these pointers and how they will be deleted, so we use shared
+ // pointers.
+ ///
+ typedef std::shared_ptr<html::StartTag> TagPtr;
+ typedef std::deque<TagPtr> TagDeque;
+ ///
+ template <typename T>
+ TagPtr makeTagPtr(T const & tag) { return std::make_shared<T>(tag); }
+ ///
+ TagDeque pending_tags_;
+ ///
+ TagDeque tag_stack_;
+};
+
+///
+void xhtmlParagraphs(Text const & text,