[Bug 202303] [patch] Better configuration for Emacs

[bugzilla-noreply at freebsd.org]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=202303

            Bug ID: 202303
           Summary: [patch] Better configuration for Emacs
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Keywords: patch
          Severity: Affects Some People
          Priority: ---
         Component: Documentation
          Assignee: freebsd-doc at FreeBSD.org
          Reporter: trig4800 at gmail.com
          Keywords: patch

Created attachment 159839
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=159839&action=edit
Change in en_US.ISO8859-1/books/fdp-primer/editor-config/chapter.xml

FDP requires following guidelines:

- Word wrap set to 70 characters.
- Tab stops set to 2.
- Replace each group of 8 leading spaces with a single tab.

Configuration for Emacs is suggested in FDP Primer:

https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/editor-config-emacs.html

However, this method(psgml-mode) is not a good one, because:

1. It doesn't work properly.
2. It's too old.
3. It is not the built-in feature of Emacs.

When editing xml files with *modern* Emacs, nxml-mode is usually recommended.
It is also default setting for Emacs.

nxml-mode combined with auto-fill-mode can do the job.

Specifically, adding this line to ~/.emacs:

(add-hook 'nxml-mode-hook 'turn-on-auto-fill)

I'm translating some articles with this configuration, and it seems to be
working well.

P.S. These are my questions related to this topic:

https://lists.freebsd.org/pipermail/freebsd-doc/2015-June/025339.html
http://stackoverflow.com/questions/31359658/emacs-configuration-for-xml-files-of-freebsd-documentation-project
https://forums.freebsd.org/threads/emacs-configuration-for-freebsd-documentation-project.51857/#post-294083

And this is a manual for nxml-mode from GNU Project.

https://www.gnu.org/software/emacs/manual/html_node/nxml-mode/index.html

-- 
You are receiving this mail because:
You are the assignee for the bug.