From: Doug Evans Date: Thu, 16 Jul 2009 17:53:25 +0000 (+0000) Subject: * cpu/simplify.inc (*): One line doc strings don't need \n. X-Git-Tag: msnyder-checkpoint-072509-branchpoint~88 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=0aaaf7c3ef758c804f78ecab8dc36f247c4651d9;p=platform%2Fupstream%2Fbinutils.git * 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. --- diff --git a/cpu/ChangeLog b/cpu/ChangeLog index f1fb321..5a47a68 100644 --- a/cpu/ChangeLog +++ b/cpu/ChangeLog @@ -1,3 +1,10 @@ +2009-07-16 Doug Evans + + * 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 * m32c.opc (parse_lab_5_3): Use correct enum. diff --git a/cpu/simplify.inc b/cpu/simplify.inc index 6a20245..808018d 100644 --- a/cpu/simplify.inc +++ b/cpu/simplify.inc @@ -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. ; @@ -28,75 +28,69 @@ ; 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) ) ; 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) ) ; 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 ) ; 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 ) @@ -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 )