* cpu/simplify.inc (*): One line doc strings don't need \n.
authorDoug Evans <dje@google.com>
Thu, 16 Jul 2009 17:53:25 +0000 (17:53 +0000)
committerDoug Evans <dje@google.com>
Thu, 16 Jul 2009 17:53:25 +0000 (17:53 +0000)
(df): Invoke define-full-ifield instead of claiming it's an alias.
(dno): Define.
(dnop): Mark as deprecated.

cpu/ChangeLog
cpu/simplify.inc

index f1fb321428055b6d79f1d63a019121e403dfbf9a..5a47a6877e0585bc07cc3e667090efeb559f7394 100644 (file)
@@ -1,3 +1,10 @@
+2009-07-16  Doug Evans  <dje@sebabeach.org>
+
+       * cpu/simplify.inc (*): One line doc strings don't need \n.
+       (df): Invoke define-full-ifield instead of claiming it's an alias.
+       (dno): Define.
+       (dnop): Mark as deprecated.
+
 2009-06-22  Alan Modra  <amodra@bigpond.net.au>
 
        * m32c.opc (parse_lab_5_3): Use correct enum.
index 6a20245949c58ac14f145d9a8db91cd9488187ff..808018dc83ddae2ef47eeed6818d78b176b8f524 100644 (file)
@@ -1,6 +1,6 @@
 ; Collection of macros, for GNU Binutils .cpu files. -*- Scheme -*-
 ;
-; Copyright 2000, 2007 Free Software Foundation, Inc.
+; Copyright 2000, 2007, 2009 Free Software Foundation, Inc.
 ;
 ; Contributed by Red Hat Inc.
 ;
 ; that way (it's define-full-enum that would change).
 
 (define-pmacro (define-normal-enum name comment attrs prefix vals)
-  "\
-Define a normal enum, fixed number of arguments.
-"
+  "Define a normal enum, fixed number of arguments."
   (define-full-enum name comment attrs prefix vals)
 )
 
 ; Define a normal insn enum.
 
 (define-pmacro (define-normal-insn-enum name comment attrs prefix fld vals)
-  "\
-Define a normal instruction opcode enum.
-"
+  "Define a normal instruction opcode enum."
   (define-full-insn-enum name comment attrs prefix fld vals)
 )
 \f
 ; Instruction fields.
 
-; Normally, fields are unsigned have no encode/decode needs.
+; Normally, fields are unsigned and have no encode/decode needs.
 
 (define-pmacro (define-normal-ifield name comment attrs start length)
-  "Define a normal instruction field.\n"
+  "Define a normal instruction field."
   (define-full-ifield name comment attrs start length UINT #f #f)
 )
 
 ; For those who don't like typing.
 
-(define-pmacro df
-  "Shorthand form of define-full-ifield.\n"
-  define-full-ifield
+(define-pmacro (df name comment attrs start length mode encode decode)
+  "Shorthand form of normal fields requiring mode, encode/decode."
+  (define-full-ifield name comment attrs start length mode encode decode)
 )
 (define-pmacro dnf
-  "Shorthand form of define-normal-ifield.\n"
+  "Shorthand form of define-normal-ifield."
   define-normal-ifield
 )
 
 ; Define a normal multi-ifield.
-; FIXME: The define-normal version for ifields doesn't include the mode.
 
 (define-pmacro (define-normal-multi-ifield name comment attrs
                 mode subflds insert extract)
-  "Define a normal multi-part instruction field.\n"
+  "Define a normal multi-part instruction field."
   (define-full-multi-ifield name comment attrs mode subflds insert extract)
 )
 
 ; For those who don't like typing.
 
 (define-pmacro dnmf
-  "Shorthand form of define-normal-multi-ifield.\n"
+  "Shorthand form of define-normal-multi-ifield."
   define-normal-multi-ifield
 )
 
-; Simple multi-ifields: mode is UINT, default insert/extract support.
+; Simple multi-ifields: mode is UINT, default insert/extract support,
+; default encode/decode support.
 
 (define-pmacro (dsmf name comment attrs subflds)
-  "Define a simple multi-part instruction field.\n"
+  "Define a simple multi-part instruction field."
   (define-full-multi-ifield name comment attrs UINT subflds #f #f)
 )
 \f
 ; Hardware.
 
 ; Simpler version for most hardware elements.
-; Allow special assembler support specification but no semantic-name or
-; get/set specs.
+; Allow special assembler support specification but no semantic-name,
+; getter/setter, or layout specs.
 
 (define-pmacro (define-normal-hardware name comment attrs type
                 indices values handlers)
-  "\
-Define a normal hardware element.
-"
+  "Define a normal hardware element."
   (define-full-hardware name comment attrs name type
     indices values handlers () () ())
 )
@@ -104,12 +98,12 @@ Define a normal hardware element.
 ; For those who don't like typing.
 
 (define-pmacro dnh
-  "Shorthand form of define-normal-hardware.\n"
+  "Shorthand form of define-normal-hardware."
   define-normal-hardware
 )
 
 ; Simpler version of dnh that leaves out the indices, values, handlers,
-; get, set, and layout specs.
+; getter/setter, and layout specs.
 ; This is useful for 1 bit registers.
 ; ??? While dsh and dnh aren't that distinguishable when perusing a .cpu file,
 ; they both take a fixed number of positional arguments, and dsh is a proper
@@ -117,29 +111,37 @@ Define a normal hardware element.
 ; are ok.
 
 (define-pmacro (define-simple-hardware name comment attrs type)
-  "\
-Define a simple hardware element (usually a scalar register).
-"
+  "Define a simple hardware element (usually a scalar register)."
   (define-full-hardware name comment attrs name type () () () () () ())
 )
 
 (define-pmacro dsh
-  "Shorthand form of define-simple-hardware.\n"
+  "Shorthand form of define-simple-hardware."
   define-simple-hardware
 )
 \f
 ; Operands.
 
+; Simpler version for most operands.
+; Allow special assembler support specification but no handlers or
+; getter/setter specs.
+
 (define-pmacro (define-normal-operand name comment attrs type index)
-  "Define a normal operand.\n"
+  "Define a normal operand."
   (define-full-operand name comment attrs type DFLT index () () ())
 )
 
 ; For those who don't like typing.
-; FIXME: dno?
+
+(define-pmacro dno
+  "Shorthand form of define-normal-operand."
+  define-normal-operand
+)
+
+; Deprecated, but still in wide use.
 
 (define-pmacro dnop
-  "Shorthand form of define-normal-operand.\n"
+  "Shorthand form of define-normal-operand."
   define-normal-operand
 )
 
@@ -167,7 +169,7 @@ Define a simple hardware element (usually a scalar register).
 ; Fields ifield-assertion is absent.
 
 (define-pmacro (define-normal-insn name comment attrs syntax fmt semantics timing)
-  "Define a normal instruction.\n"
+  "Define a normal instruction."
   (define-full-insn name comment attrs syntax fmt () semantics timing)
 )
 
@@ -176,7 +178,7 @@ Define a simple hardware element (usually a scalar register).
 ; this must be the right way to go. :-)
 
 (define-pmacro dni
-  "Shorthand form of define-normal-insn.\n"
+  "Shorthand form of define-normal-insn."
   define-normal-insn
 )
 \f
@@ -186,14 +188,14 @@ Define a simple hardware element (usually a scalar register).
 ; This only supports expanding to one real insn.
 
 (define-pmacro (define-normal-macro-insn name comment attrs syntax expansion)
-  "Define a normal macro instruction.\n"
+  "Define a normal macro instruction."
   (define-full-minsn name comment attrs syntax expansion)
 )
 
 ; To reduce the amount of typing.
 
 (define-pmacro dnmi
-  "Shorthand form of define-normal-macro-insn.\n"
+  "Shorthand form of define-normal-macro-insn."
   define-normal-macro-insn
 )
 \f