Bug 211184 - Update Emacs Section of Editor Configuration Chapter in FDP Primer
Summary: Update Emacs Section of Editor Configuration Chapter in FDP Primer
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Warren Block
URL:
Keywords: patch
Depends on:
Blocks:
 
Reported: 2016-07-18 02:33 UTC by Joseph Mingrone
Modified: 2016-08-05 20:26 UTC (History)
1 user (show)

See Also:


Attachments
svn diff for editor-config chapter in the FDP primer (4.28 KB, patch)
2016-07-18 02:33 UTC, Joseph Mingrone
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
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