From: Aahz <aa...@py...> - 2005-10-08 23:22:09
|
On Tue, Oct 04, 2005, David Goodger wrote: > [Felix Wiemann] >> >> That looks better, but what's wrong with using the "figure" >> directive instead of "formal"? The only difference is "title" >> vs. "caption". > > No, the difference is "Figure 1:" vs. "Table 1:" as well (sequence and > pattern). It's overloading the "figure" directive to do something it > wasn't meant to do. Re-reading this, I'm starting to really hate "formal". (Then again, I haven't been playing close attention to this discussion, which has been long-winded and nitpicky -- I'd really appreciate a summary similar to a PEP, though not as, er, formal.) Let's use "sequenced" or "enumerated" instead. Another idea: borrow from HTML and call them ordered/unordered. > Here's a thought: we could apply the "container" element to the > problem. "Container" could begin with an optional "title" element, > and have a "sequence" attribute. It could be used for both generic > formal *and* informal container elements. This appeals to me. Another comment: I don't know how many people on docutils-develop don't read -users; that's another good reason for writing a summary. -- Aahz (aa...@py...) <*> http://www.pythoncraft.com/ "If you think it's expensive to hire a professional to do the job, wait until you hire an amateur." --Red Adair |