[seam-dev] formatting the reference doc source

Pete Muir pmuir at redhat.com
Thu Apr 15 12:38:23 EDT 2010


The easiest option I know is just to use the Eclipse XML editor and never use the autoformat feature.

Of course, people do use the autoformat feature, so sometimes we have to reset it back to what it should look like.

On 15 Apr 2010, at 17:22, Dan Allen wrote:

> Stuart (et al),
> 
> To follow up on your question from IRC, we don't have to use vim for formatting the reference docs source (docbook). What I want to avoid is reflows of the XML because that makes it virtually impossible to track changes. So far, vim gives me the maximum control over that. Eclipse loves to reformat the whole document in ways i don't agree with. I've tried other docbook editors, and they seem to have their own way of formatting too. If we can find a way to avoid reflows and use something better than vim, I'm all ears. Vim isn't the greatest at editing XML anyway.
> 
> ...however, the modelines I suggested [1] to set a target for the formatting that we want.
> 
> -Dan
> 
> [1] http://seamframework.org/Documentation/ReferenceDocumentationStyleGuide
> 
> -- 
> Dan Allen
> Senior Software Engineer, Red Hat | Author of Seam in Action
> Registered Linux User #231597
> 
> http://mojavelinux.com
> http://mojavelinux.com/seaminaction
> http://www.google.com/profiles/dan.j.allen
> _______________________________________________
> seam-dev mailing list
> seam-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/seam-dev




More information about the seam-dev mailing list