From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 25957 invoked by alias); 30 Nov 2002 08:25:01 -0000 Mailing-List: contact cgen-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: cgen-owner@sources.redhat.com Received: (qmail 25885 invoked from network); 30 Nov 2002 08:25:00 -0000 Received: from unknown (HELO miranda.axis.se) (193.13.178.2) by sources.redhat.com with SMTP; 30 Nov 2002 08:25:00 -0000 Received: from ignucius.axis.se (ignucius.axis.se [10.13.1.18]) by miranda.axis.se (8.12.3/8.12.3/Debian -4) with ESMTP id gAU8OwxS022830; Sat, 30 Nov 2002 09:24:58 +0100 Received: from ignucius.axis.se (localhost [127.0.0.1]) by ignucius.axis.se (8.12.3/8.12.3/Debian -4) with ESMTP id gAU8OvQE011429 (version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=FAIL); Sat, 30 Nov 2002 09:24:57 +0100 Received: (from hp@localhost) by ignucius.axis.se (8.12.3/8.12.3/Debian -4) id gAU8Ov5t011425; Sat, 30 Nov 2002 09:24:57 +0100 Date: Sat, 30 Nov 2002 00:25:00 -0000 Message-Id: <200211300824.gAU8Ov5t011425@ignucius.axis.se> From: Hans-Peter Nilsson To: cgen@sources.redhat.com Subject: [RFA:] Improve cgen/doc/rtl.texi wrt. timing and PROFILE. X-SW-Source: 2002-q4/txt/msg00040.txt.bz2 Slight improvements to the documentation, I hope. By the way, it seems toplevel configury does not create a cgen/Makefile, necessary for "make info" to take effect, even though nothing else is created object-wise. Needs fixing. Ok to commit? * doc/rtl.texi (Model variants): Mention current limitations for unit inputs and outputs. (Hardware elements) : Be slightly more verbose. (Instructions) : input/output overrides have a direction operand. Index: rtl.texi =================================================================== RCS file: /cvs/src/src/cgen/doc/rtl.texi,v retrieving revision 1.15 diff -c -p -r1.15 rtl.texi *** rtl.texi 29 Jan 2002 22:51:52 -0000 1.15 --- rtl.texi 30 Nov 2002 08:13:20 -0000 *************** function unit called @samp{u-cmp} is def *** 755,761 **** This handles instructions that use src1 and src2 as operands. The organization of units is arbitrary. On the M32R, src1/src2 instructions are typically compare instructions so a separate function unit was ! created for them. @node Hardware elements @section Hardware Elements --- 755,763 ---- This handles instructions that use src1 and src2 as operands. The organization of units is arbitrary. On the M32R, src1/src2 instructions are typically compare instructions so a separate function unit was ! created for them. Current limitations require that each hardware item ! behind the operands must be marked with the attribute @code{PROFILE} and ! the hardware item must not be scalar. @node Hardware elements @section Hardware Elements *************** with @code{VIRTUAL} (??? revisit). *** 813,820 **** @item PROFILE ! Ignore. This is a work-in-progress to define how to profile references ! to hardware elements. @item VIRTUAL --- 815,823 ---- @item PROFILE ! This attribute must be present for hardware elements to which references ! are profiled. Beware, this is work-in-progress. If you use this ! attribute it is likely you have to hack CGEN. (Please submit patches.) @item VIRTUAL *************** that supports the instruction. The defa *** 1866,1879 **** The syntax is: @example ! (mach-name (unit name (unit-var-name1 insn-operand-name1) ! (unit-var-name2 insn-operand-name2) ... (cycles cycle-count)) @end example ! unit-var-name/insn-operand-name mappings are optional. ! They map unit inputs/outputs to semantic elements. @code{cycles} overrides the @code{done} value (latency) of the function unit and is optional. --- 1869,1885 ---- The syntax is: @example ! (mach-name (unit name (direction unit-var-name1 insn-operand-name1) ! (direction unit-var-name2 insn-operand-name2) ... (cycles cycle-count)) @end example ! direction/unit-var-name/insn-operand-name mappings are optional. ! They map unit inputs/outputs to semantic elements. The ! direction specifier can be @code{in} or @code{out} mapping the ! name of a unit input or output, respectively, to an insn ! operand. @code{cycles} overrides the @code{done} value (latency) of the function unit and is optional. brgds, H-P