Difference between revisions of "RRM 3-14 Editing Tasks"

From EPICSWIKI
 
(→‎Record Documentation/Distribution Anomalies: Add missing "Async Soft Channel" device support documentation)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
== To Do List ==
== To Do List ==


The purpose of this list is to bring the existing R3.14 Record Reference Manual up to match the current R3.14.9 implementation.  A separate effort can then be made to come out with a version of the manual for R3.14.x, starting from the R3.13.10 version.
The purpose of this list is to bring the existing R3.14 Record Reference Manual up to match the current R3.14.9 implementation.


* Read [[RRM 3-14 Concepts|Database Concepts]] and revise as necessary.
* Read [[RRM 3-14 Concepts|Database Concepts]] and revise as necessary.
Line 16: Line 16:


=== Record Documentation/Distribution Anomalies ===
=== Record Documentation/Distribution Anomalies ===
These records have "Async Soft Channel" device support but do not document this:
* Analog Output
* Binary Output
* Calculation Output
* Long Output
* Multi-Bit Binary Output
* Multi-Bit Binary Output Direct
* String Output


These records are documented here but not present in any distribution of EPICS Base:
These records are documented here but not present in any distribution of EPICS Base:

Latest revision as of 21:17, 18 October 2012

To Do List

The purpose of this list is to bring the existing R3.14 Record Reference Manual up to match the current R3.14.9 implementation.

  • Read Database Concepts and revise as necessary.
    • Maybe replace the existing CapFast diagrams with VDCT equivalents.
  • For Fields Common to All Record Types update the field tables and descriptions according to how dbCommon has changed.
  • Check Fields Common to Many Record Types for typical changes made across all record types.
  • For each existing record chapter we need to update its for
    • Changes to individual fields
    • Changes made to the record processing description
    • Fix shortcomings of the existing text, e.g.
      • Missing sections
      • Device support report() function prototypes
  • For Menu Choices check and update the list of menus and choices in each.

Record Documentation/Distribution Anomalies

These records have "Async Soft Channel" device support but do not document this:

  • Analog Output
  • Binary Output
  • Calculation Output
  • Long Output
  • Multi-Bit Binary Output
  • Multi-Bit Binary Output Direct
  • String Output

These records are documented here but not present in any distribution of EPICS Base:

  • Archive
  • CPID

These records are not documented here, but are present in both the R3.13.10 and R3.14.x distributions:

  • Analog Array Input
  • Analog Array Output

These records are neither documented here nor present in any distribution of Base, but being commonly used they are candidates for possible inclusion in the documentation:

  • Enhanced PID
  • genSub
  • Motor
  • Transform
  • Table
  • waveformAnalysis
  • ... other ...

Don't add pages for these obsolete records, which were present in the R3.13.10 distribution but removed in R3.14.x:

  • Event Generator Event
  • Event Generator
  • Event Receiver Event
  • Event Receiver
  • GSub (not Andy Foster's genSub)
  • recDynLink
  • recWaitCa