Bug 211184

Summary: Update Emacs Section of Editor Configuration Chapter in FDP Primer
Product: Documentation Reporter: Joseph Mingrone <jrm>
Component: Books & ArticlesAssignee: Warren Block <wblock>
Status: Closed FIXED    
Severity: Affects Only Me CC: wblock
Priority: --- Keywords: patch
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
svn diff for editor-config chapter in the FDP primer none

Description Joseph Mingrone freebsd_committer freebsd_triage 2016-07-18 02:33:03 UTC
Created attachment 172626 [details]
svn diff for editor-config chapter in the FDP primer

- Remove the reference to XEmacs since it is effectively dead
- Add content about
  - On-the-fly XML validation using nxml-mode and the FDP's DocBook-based compact relax NG schema
  - On-the-fly proofreading with Flycheck and Igor
  - FDP-specific settings
- Fix an Igor warning about a long line
Comment 1 Joseph Mingrone freebsd_committer freebsd_triage 2016-07-18 14:19:48 UTC
A few other points:

- Proofreading with Igor depends on a small patch I sent to Warren.

- XML validation will report errors in some modules because of the way shared entites are dealt with in the FDP.  I posted about this on doc@ and now have a few potential solutions for individually validating included files like chapters.

- By default, nxml-mode and Igor don't agree on how code should be indented.  This just means that users will have to manually indent some code.  I submitted an update to nxml-mode on emacs-devel@gnu.org.  Hopefully that, or a similar change, will be incorporated to give more control over nxml-mode's indentation.
Comment 2 commit-hook freebsd_committer freebsd_triage 2016-08-05 20:24:10 UTC
A commit references this bug:

Author: wblock
Date: Fri Aug  5 20:23:26 UTC 2016
New revision: 49219
URL: https://svnweb.freebsd.org/changeset/doc/49219

Log:
  Update Emacs section of editor configuration chapter in FDP Primer.

  PR:		211184
  Submitted by:	Joseph Mingrone <jrm@ftfl.ca>

Changes:
  head/en_US.ISO8859-1/books/fdp-primer/editor-config/chapter.xml