# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2021-11-07 12:12+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: top #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:4 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:55 #, no-wrap msgid "VHDL Mode, an Emacs mode for editing VHDL code" msgstr "" #. type: include #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:5 #, no-wrap msgid "docstyle.texi" msgstr "" #. type: copying #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:12 msgid "This file documents VHDL Mode, an Emacs mode for editing VHDL code." msgstr "" #. type: copying #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:15 msgid "" "Copyright @copyright{} 1995--2008, 2010, 2012, 2015--2021 Free Software " "Foundation, Inc." msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:23 msgid "" "Permission is granted to copy, distribute and/or modify this document under " "the terms of the GNU Free Documentation License, Version 1.3 or any later " "version published by the Free Software Foundation; with no Invariant " "Sections, with the Front-Cover texts being ``A GNU Manual,'' and with the " "Back-Cover Texts as in (a) below. A copy of the license is included in the " "section entitled ``GNU Free Documentation License.''" msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:26 msgid "" "(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and modify " "this GNU manual.''" msgstr "" #. type: dircategory #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:29 #, no-wrap msgid "Emacs editing modes" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:32 msgid "VHDL Mode: (vhdl-mode)" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:32 msgid "Emacs mode for editing VHDL code." msgstr "" #. type: title #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:37 #, no-wrap msgid "VHDL Mode" msgstr "" #. type: subtitle #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:39 #, no-wrap msgid "A GNU Emacs mode for editing VHDL code." msgstr "" #. type: author #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:41 #, no-wrap msgid "Reto Zimmermann" msgstr "" #. type: email{#1} #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:42 #, no-wrap msgid "reto@@gnu.org" msgstr "" #. type: author #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:43 #, no-wrap msgid "Rod Whitby" msgstr "" #. type: email{#1} #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:44 #, no-wrap msgid "software.vhdl-mode@@rwhitby.net" msgstr "" #. type: node #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:54 #, no-wrap msgid "Top" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 msgid "Introduction::" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 msgid "Getting Connected::" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 msgid "New Indentation Engine::" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 msgid "Customizing Indentation::" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 msgid "Syntactic Symbols::" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 msgid "Frequently Asked Questions::" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 msgid "Getting the latest VHDL Mode release::" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 msgid "Sample Init File::" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 msgid "Limitations and Known Bugs::" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 msgid "Mailing Lists and Submitting Bug Reports::" msgstr "" #. type: appendix #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:982 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:983 #, no-wrap msgid "GNU Free Documentation License" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 msgid "The license for this documentation." msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 msgid "Concept Index::" msgstr "" #. type: unnumbered #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:993 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:994 #, no-wrap msgid "Command Index" msgstr "" #. type: unnumbered #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:1005 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:1006 #, no-wrap msgid "Key Index" msgstr "" #. type: unnumbered #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:76 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:1011 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:1012 #, no-wrap msgid "Variable Index" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:78 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:79 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:80 #, no-wrap msgid "Introduction" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:84 msgid "" "Welcome to VHDL Mode. This is a GNU Emacs mode for editing files containing " "VHDL code." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:86 msgid "This manual will describe the following:" msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:90 msgid "How to get started using VHDL Mode." msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:93 msgid "How the indentation engine works." msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:96 msgid "How to customize the indentation engine." msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:99 #, no-wrap msgid "vhdl-version" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:104 msgid "" "The major version number was incremented to 3 with the addition of many new " "features for editing VHDL code to the new indentation engine, which was " "introduced in major version 2. To find the minor revision number of this " "release, use @kbd{M-x vhdl-version @key{RET}}." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:109 msgid "" "A special word of thanks goes to Rod Whitby, who wrote the VHDL Mode " "indentation engine, and to Barry Warsaw, who wrote the CC Mode indentation " "engine that formed the basis thereof. Their manuals were also the basis for " "this manual." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:116 msgid "" "This manual is not very up-to-date. It basically contains the indentation " "machine documentation by Rod Whitby with only minor adaptions. A short " "documentation of the entire VHDL Mode is available within the mode itself by " "typing @kbd{C-c C-h}. Also, all commands and customization of most variables " "are available through the menu, which makes everything highly " "self-explaining." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:117 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:118 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:119 #, no-wrap msgid "Getting Connected" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:123 msgid "" "To get started, simply visit a @file{.vhd} file in Emacs; or type @kbd{M-x " "vhdl-mode @key{RET}}." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:124 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:125 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:126 #, no-wrap msgid "New Indentation Engine" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:134 msgid "" "VHDL Mode has a new indentation engine, providing a simplified, yet flexible " "and general mechanism for customizing indentation. It breaks indentation " "calculation into two steps. First for the line of code being indented, VHDL " "Mode analyzes what kind of language construct it's looking at, then it " "applies user defined offsets to the current line based on this analysis." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:139 msgid "" "This section will briefly cover how indentation is calculated in VHDL " "Mode. It is important to understand the indentation model being used so that " "you will know how to customize VHDL Mode for your personal coding style." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:143 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:145 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:146 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:147 #, no-wrap msgid "Syntactic Analysis" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:143 msgid "Step 1 -- Syntactic Analysis" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:143 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:239 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:240 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:241 #, no-wrap msgid "Indentation Calculation" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:143 msgid "Step 2 -- Indentation Calculation" msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:149 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:243 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:627 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:767 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:795 #, no-wrap msgid "vhdl-offsets-alist" msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:150 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:244 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:628 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:768 #, no-wrap msgid "offsets-alist @r{(vhdl-)}" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:151 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:155 #, no-wrap msgid "relative buffer position" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:152 #, no-wrap msgid "syntactic symbol" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:153 #, no-wrap msgid "syntactic component" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:154 #, no-wrap msgid "syntactic component list" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:167 msgid "" "The first thing VHDL Mode does when indenting a line of code, is to analyze " "the line, determining the @dfn{syntactic component list} of the construct on " "that line. A @dfn{syntactic component} consists of a pair of information " "(in lisp parlance, a @emph{cons cell}), where the first part is a " "@dfn{syntactic symbol}, and the second part is a @dfn{relative buffer " "position}. Syntactic symbols describe elements of VHDL code, e.g., " "@code{statement}, @code{comment}, @code{block-open}, @code{block-close}, " "etc. @xref{Syntactic Symbols}, for a complete list of currently recognized " "syntactic symbols and their semantics. Also, the variable " "@code{vhdl-offsets-alist} contains the list of currently supported syntactic " "symbols." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:171 msgid "" "Conceptually, a line of VHDL code is always indented relative to the " "indentation of some line higher up in the buffer. This is represented by " "the relative buffer position in the syntactic component." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:175 msgid "" "It might help to see an example. Suppose we had the following code as the " "only thing in a VHDL Mode buffer @footnote{The line numbers in this and " "future examples don't actually appear in the buffer.}:" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:183 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:270 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:402 #, no-wrap msgid "" " 1: inverter : process\n" " 2: begin\n" " 3: q <= not d;\n" " 4: wait on d;\n" " 5: end inverter;\n" "\n" msgstr "" #. type: kindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:187 #, no-wrap msgid "C-c C-x" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:188 #, no-wrap msgid "vhdl-show-syntactic-information" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:189 #, no-wrap msgid "show-syntactic-information @r{(vhdl-)}" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:194 msgid "" "We can use the command @kbd{C-c C-x} " "(@code{vhdl-show-syntactic-information}) to simply report what the syntactic " "analysis is for the current line. Running this command on line 4 of example " "1, we'd see in the echo area:" msgstr "" #. type: example #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:197 #, no-wrap msgid "" "((statement . 28))\n" "\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:203 msgid "" "This tells us that the line is a statement and it is indented relative to " "buffer position 28, which happens to be the @samp{q} on line 3. If you were " "to move point to line 3 and hit @kbd{C-c C-x}, you would see:" msgstr "" #. type: example #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:206 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:281 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:427 #, no-wrap msgid "" "((statement-block-intro . 20))\n" "\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:212 msgid "" "This indicates that line 3 is the first statement in a block, and is " "indented relative to buffer position 20, which is the @samp{b} in the " "@code{begin} keyword on line 2." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:213 #, no-wrap msgid "comment only line" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:218 msgid "" "Syntactic component lists can contain more than one component, and " "individual syntactic components need not have relative buffer positions. " "The most common example of this is a line that contains a @dfn{comment only " "line}." msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:222 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:678 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:763 #, no-wrap msgid "" "%%% TBD %%%\n" "\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:228 msgid "Hitting @kbd{C-c C-x} on line 3 of the example gives us:" msgstr "" #. type: example #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:231 #, no-wrap msgid "" "((comment-intro) (block-intro . 46))\n" "\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:238 msgid "" "so you can see that the syntactic component list contains two syntactic " "components. Also notice that the first component, @samp{(comment-intro)} " "has no relative buffer position." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:249 msgid "" "Indentation for the current line is calculated using the syntactic component " "list derived in step 1 above (see @ref{Syntactic Analysis}). Each component " "contributes to the final total indentation of the line in two ways." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:254 msgid "" "First, the syntactic symbols are looked up in the @code{vhdl-offsets-alist} " "variable, which is an association list of syntactic symbols and the offsets " "to apply for those symbols. These offsets are added to the running total." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:259 msgid "" "Second, if the component has a relative buffer position, VHDL Mode adds the " "column number of that position to the running total. By adding up the " "offsets and columns for every syntactic component on the list, the final " "total indentation for the current line is computed." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:262 msgid "" "Let's use our code example above to see how this works. Here is our example " "again." msgstr "" #. type: key{#1} #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:274 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:305 #, no-wrap msgid "TAB" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:278 msgid "" "Let's say point is on line 3 and we hit the @key{TAB} key to re-indent the " "line. Remember that the syntactic component list for that line is:" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:289 msgid "" "VHDL Mode looks up @code{statement-block-intro} in the " "@code{vhdl-offsets-alist} variable. Let's say it finds the value @samp{2}; " "it adds this to the running total (initialized to zero), yielding a running " "total indentation of 2 spaces." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:297 msgid "" "Next VHDL Mode goes to buffer position 20 and asks for the current column. " "Since the @code{begin} keyword at buffer position 20 is in column zero, it " "adds @samp{0} to the running total. Since there is only one syntactic " "component on the list for this line, indentation calculation is complete, " "and the total indentation for the line is 2 spaces. Simple, huh?" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:302 msgid "" "Actually, the mode usually just does The Right Thing without you having to " "think about it in this much detail. But when customizing indentation, it's " "helpful to understand the general indentation model being used." msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:303 #, no-wrap msgid "vhdl-echo-syntactic-information-p" msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:304 #, no-wrap msgid "echo-syntactic-information-p @r{(vhdl-)}" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:310 msgid "" "To help you configure VHDL Mode, you can set the variable " "@code{vhdl-echo-syntactic-information-p} to non-@code{nil} so that the " "syntactic component list and calculated offset will always be echoed in the " "minibuffer when you hit @kbd{@key{TAB}}." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:313 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:314 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:315 #, no-wrap msgid "Indentation Commands" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:321 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:322 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:323 #, no-wrap msgid "Customizing Indentation" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:325 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:430 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:629 #, no-wrap msgid "vhdl-set-offset" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:326 #, no-wrap msgid "set-offset (vhdl-)" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:336 msgid "" "The @code{vhdl-offsets-alist} variable is where you customize all your " "indentations. You simply need to decide what additional offset you want to " "add for every syntactic symbol. You can use the command @kbd{C-c O} " "(@code{vhdl-set-offset}) as the way to set offsets, both interactively and " "from your mode hook. Also, you can set up @emph{styles} of indentation. " "Most likely, you'll find one of the pre-defined styles will suit your needs, " "but if not, this section will describe how to set up basic editing " "configurations. @xref{Styles}, for an explanation of how to set up named " "styles." msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:337 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:646 #, no-wrap msgid "vhdl-basic-offset" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:338 #, no-wrap msgid "basic-offset (vhdl-)" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:345 msgid "" "As mentioned previously, the variable @code{vhdl-offsets-alist} is an " "association list between syntactic symbols and the offsets to be applied for " "those symbols. In fact, these offset values can be an integer, a function " "or variable name, or one of the following symbols: @code{+}, @code{-}, " "@code{++}, @code{--}, @code{*}, or @code{/}. The symbol values have the " "following meanings:" msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:350 msgid "@code{+} -- 1 x @code{vhdl-basic-offset}" msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:352 msgid "@code{-} -- -1 x @code{vhdl-basic-offset}" msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:354 msgid "@code{++} -- 2 x @code{vhdl-basic-offset}" msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:356 msgid "@code{--} -- -2 x @code{vhdl-basic-offset}" msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:358 msgid "@code{*} -- 0.5 x @code{vhdl-basic-offset}" msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:360 msgid "@code{/} -- -0.5 x @code{vhdl-basic-offset}" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:369 msgid "" "So, for example, because most of the default offsets are defined in terms of " "@code{+}, @code{-}, and @code{0}, if you like the general indentation style, " "but you use 2 spaces instead of 4 spaces per level, you can probably achieve " "your style just by changing @code{vhdl-basic-offset} like so (in your " "@file{.emacs} file):" msgstr "" #. type: example #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:372 #, no-wrap msgid "" "(setq vhdl-basic-offset 2)\n" "\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:380 msgid "" "To change indentation styles more radically, you will want to change the " "value associated with the syntactic symbols in the @code{vhdl-offsets-alist} " "variable. First, I'll show you how to do that interactively, then I'll " "describe how to make changes to your @file{.emacs} file so that your changes " "are more permanent." msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:386 msgid "Interactive Customization::" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:386 msgid "Permanent Customization::" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:386 msgid "Styles::" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:386 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:640 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:641 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:642 #, no-wrap msgid "Advanced Customizations" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:388 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:389 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:390 #, no-wrap msgid "Interactive Customization" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:394 msgid "" "As an example of how to customize indentation, let's change the style of the " "example above from:" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:407 msgid "to:" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:415 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:461 #, no-wrap msgid "" " 1: inverter : process\n" " 2: begin\n" " 3: q <= not d;\n" " 4: wait on d;\n" " 5: end inverter;\n" "\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:424 msgid "" "In other words, we want to change the indentation of the statements inside " "the inverter process. Notice that the construct we want to change starts on " "line 3. To change the indentation of a line, we need to see which syntactic " "component affect the offset calculations for that line. Hitting @kbd{C-c " "C-x} on line 3 yields:" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:431 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:630 #, no-wrap msgid "set-offset @r{(vhdl-)}" msgstr "" #. type: kindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:432 #, no-wrap msgid "C-c O" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:441 msgid "" "So we know that to change the offset of the first signal assignment, we need " "to change the indentation for the @code{statement-block-intro} syntactic " "symbol. To do this interactively, just hit @kbd{C-c O} " "(@code{vhdl-set-offset}). This prompts you for the syntactic symbol to " "change, providing a reasonable default. In this case, the default is " "@code{statement-block-intro}, which is just the syntactic symbol we want to " "change!" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:448 msgid "" "After you hit return, VHDL Mode will then prompt you for the new offset " "value, with the old value as the default. The default in this case is " "@samp{+}, so hit backspace to delete the @samp{+}, then hit @samp{++} and " "@kbd{RET}. This will associate an offset of twice the basic indent with the " "syntactic symbol @code{statement-block-intro} in the " "@code{vhdl-offsets-alist} variable." msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:449 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:756 #, no-wrap msgid "vhdl-indent-defun" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:450 #, no-wrap msgid "indent-defun @r{(vhdl-)}" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:453 msgid "" "To check your changes quickly, just enter @kbd{M-x vhdl-indent-defun} to " "reindent the entire function. The example should now look like:" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:471 msgid "" "Notice how just changing the offset on line 3 is all we needed to do. Since " "the other affected lines are indented relative to line 3, they are " "automatically indented the way you'd expect. For more complicated examples, " "this may not always work. The general approach to take is to always start " "adjusting offsets for lines higher up in the file, then re-indent and see if " "any following lines need further adjustments." msgstr "" #. type: node #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:472 #, no-wrap msgid "Permanent Customization" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:473 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:474 #, no-wrap msgid "Permanent Indentation" msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:476 #, no-wrap msgid "vhdl-mode-hook" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:477 #, no-wrap msgid "hooks" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:482 msgid "" "To make this change permanent, you need to add some lisp code to your " "@file{.emacs} file. VHDL Mode provides a @code{vhdl-mode-hook} that you can " "use to customize your language editing styles. This hook gets run as the " "last thing when you enter VHDL Mode." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:488 msgid "" "Here's a simplified example of what you can add to your @file{.emacs} file " "to make the changes described in the previous section (@ref{Interactive " "Customization}) more permanent. See the Emacs manuals for more information " "on customizing Emacs via hooks. @xref{Sample Init File}, for a more " "complete sample @file{.emacs} file." msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:498 #, no-wrap msgid "" "(defun my-vhdl-mode-hook ()\n" " ;; my customizations for all of vhdl-mode\n" " (vhdl-set-offset 'statement-block-intro '++)\n" " ;; other customizations can go here\n" " )\n" "(add-hook 'vhdl-mode-hook 'my-vhdl-mode-hook)\n" "\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:505 msgid "" "For complex customizations, you will probably want to set up a @emph{style} " "that groups all your customizations under a single name. @xref{Styles}." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:509 msgid "" "The offset value can also be a function, and this is how power users gain " "enormous flexibility in customizing indentation. @xref{Advanced " "Customizations}." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:510 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:511 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:512 #, no-wrap msgid "Styles" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:525 msgid "" "Most people only need to edit code formatted in just a few well-defined and " "consistent styles. For example, their organization might impose a " "``blessed'' style that all its programmers must conform to. Similarly, " "people who work on GNU software will have to use the GNU coding style on C " "code. Some shops are more lenient, allowing some variety of coding styles, " "and as programmers come and go, there could be a number of styles in use. " "For this reason, VHDL Mode makes it convenient for you to set up logical " "groupings of customizations called @dfn{styles}, associate a single name for " "any particular style, and pretty easily start editing new or existing code " "using these styles. This chapter describes how to set up styles and how to " "edit your C code using styles." msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:530 msgid "Built-in Styles::" msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:530 msgid "Adding Styles::" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:530 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:605 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:606 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:607 #, no-wrap msgid "File Styles" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:533 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:534 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:535 #, no-wrap msgid "Built-in Styles" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:540 msgid "" "If you're lucky, one of VHDL Mode's built-in styles might be just what " "you're looking for. Some of the most common VHDL styles are already " "built-in. These include:" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:543 #, no-wrap msgid "IEEE style" msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:545 msgid "@code{GNU} -- the coding style in the IEEE Language Reference Manual." msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:548 #, no-wrap msgid "vhdl-set-style" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:549 #, no-wrap msgid "set-style @r{(vhdl-)}" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:552 msgid "" "If you'd like to experiment with these built-in styles you can simply type " "@kbd{M-x vhdl-set-style @key{RET}} in a VHDL Mode buffer." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:556 msgid "" "You will be prompted for one of the above styles (with completion). Enter " "one of the styles and hit @kbd{RET}. Note however that setting a style in " "this way does @emph{not} automatically re-indent your file." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:565 msgid "" "Once you find a built-in style you like, you can make the change permanent " "by adding a call to your @file{.emacs} file. Let's say for example that you " "want to use the @code{IEEE} style in all your files. You would add this:" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:574 #, no-wrap msgid "" "(defun my-vhdl-mode-hook ()\n" " ;; use IEEE style for all VHDL code\n" " (vhdl-set-style \"IEEE\")\n" " ;; other customizations can go here\n" " )\n" "(add-hook 'vhdl-mode-hook 'my-vhdl-mode-hook)\n" "\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:580 msgid "@xref{Permanent Customization}." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:581 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:582 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:583 #, no-wrap msgid "Adding Styles" msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:585 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:644 #, no-wrap msgid "vhdl-style-alist" msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:586 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:645 #, no-wrap msgid "style-alist @r{(vhdl-)}" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:587 #, no-wrap msgid "vhdl-add-style" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:588 #, no-wrap msgid "add-style @r{(vhdl-)}" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:601 msgid "" "If none of the built-in styles is appropriate, you'll probably want to add a " "new style definition. Styles are kept in the @code{vhdl-style-alist} " "variable, but you probably won't want to modify this variable directly. " "VHDL Mode provides a function, called @code{vhdl-add-style}, that you can " "use to easily add new styles or update existing styles. This function takes " "two arguments, a @var{stylename} string, and an association list " "@var{description} of style customizations. If @var{stylename} is not " "already in @code{vhdl-style-alist}, the new style is added, otherwise the " "style already associated with @var{stylename} is changed to the new " "@var{description}. This function also takes an optional third argument, " "which if non-@code{nil}, automatically institutes the new style in the " "current buffer." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:604 msgid "" "The sample @file{.emacs} file provides a concrete example of how a new style " "can be added and automatically set. @xref{Sample Init File}." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:609 #, no-wrap msgid "local variables" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:616 msgid "" "The Emacs manual describes how you can customize certain variables on a " "per-file basis by including a @dfn{Local Variable} block at the end of the " "file. So far, you've only seen a functional interface to VHDL Mode, which " "is highly inconvenient for use in a Local Variable block. VHDL Mode " "provides two variables that make it easier for you to customize your style " "on a per-file basis." msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:617 #, no-wrap msgid "vhdl-file-style" msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:618 #, no-wrap msgid "file-style @r{(vhdl-)}" msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:619 #, no-wrap msgid "vhdl-file-offsets" msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:620 #, no-wrap msgid "file-offsets @r{(vhdl-)}" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:626 msgid "" "The variable @code{vhdl-file-style} can be set to a style name string as " "described in @ref{Built-in Styles}. When the file is visited, VHDL Mode " "will automatically set the file's style to this style using " "@code{vhdl-set-style}." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:635 msgid "" "Another variable, @code{vhdl-file-offsets}, takes an association list " "similar to what is allowed in @code{vhdl-offsets-alist}. When the file is " "visited, VHDL Mode will automatically institute these offsets using " "@code{vhdl-set-offset}. @xref{Customizing Indentation}." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:638 msgid "" "Note that file style settings (i.e., @code{vhdl-file-style}) are applied " "before file offset settings (i.e., @code{vhdl-file-offsets})." msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:647 #, no-wrap msgid "basic-offset @r{(vhdl-)}" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:658 msgid "" "For most users, VHDL Mode will support their coding styles with very little " "need for customizations. Usually, one of the standard styles defined in " "@code{vhdl-style-alist} will do the trick. Sometimes, one of the syntactic " "symbol offsets will need to be tweaked slightly, or perhaps " "@code{vhdl-basic-offset} will need to be changed. However, some styles " "require a more advanced ability for customization, and one of the real " "strengths of VHDL Mode is that the syntactic analysis model provides a very " "flexible framework for customizing indentation. This allows you to perform " "special indentation calculations for situations not handled by the mode " "directly." msgstr "" #. type: menuentry #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:662 msgid "Custom Indentation Functions::" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:662 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:775 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:776 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:777 #, no-wrap msgid "Other Special Indentations" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:664 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:665 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:666 #, no-wrap msgid "Custom Indentation Functions" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:668 #, no-wrap msgid "custom indentation functions" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:674 msgid "" "One of the most common ways to customize VHDL Mode is by writing @dfn{custom " "indentation functions} and associating them with specific syntactic symbols " "(see @ref{Syntactic Symbols}). VHDL Mode itself uses custom indentation " "functions to provide more sophisticated indentation, for example when lining " "up selected signal assignments:" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:691 msgid "" "In this example, the @code{statement-cont} syntactic symbol has an offset of " "@code{+}, and @code{vhdl-basic-offset} is 2, so lines 4 through 6 are simply " "indented two spaces to the right of line 3. But perhaps we'd like VHDL Mode " "to be a little more intelligent so that it offsets the waveform descriptions " "relative to the signal assignment operator in line 3. To do this, we have " "to write a custom indentation function which finds the column of signal " "assignment operator on the first line of the statement. Here is the lisp " "code (from the @file{vhdl-mode.el} source file) that implements this:" msgstr "" #. type: group #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:730 #, no-wrap msgid "" "(defun vhdl-lineup-statement-cont (langelem)\n" " ;; line up statement-cont after the assignment operator\n" " (save-excursion\n" " (let* ((relpos (cdr langelem))\n" "\t (assignp (save-excursion\n" "\t\t (goto-char (vhdl-point 'boi))\n" "\t\t (and (re-search-forward \"\\\\(<\\\\|:\\\\)=\"\n" "\t\t\t\t\t (vhdl-point 'eol) t)\n" "\t\t\t (- (point) (vhdl-point 'boi)))))\n" "\t (curcol (progn\n" "\t\t (goto-char relpos)\n" "\t\t (current-column)))\n" "\t foundp)\n" " (while (and (not foundp)\n" "\t\t (< (point) (vhdl-point 'eol)))\n" "\t(re-search-forward \"\\\\(<\\\\|:\\\\)=\\\\|(\" (vhdl-point 'eol) 'move)\n" "\t(if (vhdl-in-literal (cdr langelem))\n" "\t (forward-char)\n" "\t (if (= (preceding-char) ?\\()\n" "\t ;; skip over any parenthesized expressions\n" "\t (goto-char (min (vhdl-point 'eol)\n" "\t\t\t (scan-lists (point) 1 1)))\n" "\t ;; found an assignment operator (not at eol)\n" "\t (setq foundp (not (looking-at \"\\\\s-*$\"))))))\n" " (if (not foundp)\n" "\t ;; there's no assignment operator on the line\n" "\t vhdl-basic-offset\n" "\t;; calculate indentation column after assign and ws, unless\n" "\t;; our line contains an assignment operator\n" "\t(if (not assignp)\n" "\t (progn\n" "\t (forward-char)\n" "\t (skip-chars-forward \" \\t\")\n" "\t (setq assignp 0)))\n" "\t(- (current-column) assignp curcol))\n" " )))\n" "\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:743 msgid "" "Custom indent functions take a single argument, which is a syntactic " "component cons cell (see @ref{Syntactic Analysis}). The function returns an " "integer offset value that will be added to the running total indentation for " "the line. Note that what actually gets returned is the difference between " "the column that the signal assignment operator is on, and the column of the " "buffer relative position passed in the function's argument. Remember that " "VHDL Mode automatically adds in the column of the component's relative " "buffer position and we don't want that value added into the final total " "twice." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:744 #, no-wrap msgid "statement-cont syntactic symbol" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:745 #, no-wrap msgid "vhdl-lineup-statement-cont" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:746 #, no-wrap msgid "lineup-statement-cont @r{(vhdl-)}" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:750 msgid "" "Now, to associate the function @code{vhdl-lineup-statement-cont} with the " "@code{statement-cont} syntactic symbol, we can add something like the " "following to our @code{vhdl-mode-hook}:" msgstr "" #. type: example #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:753 #, no-wrap msgid "" "(vhdl-set-offset 'statement-cont 'vhdl-lineup-statement-cont)\n" "\n" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:759 msgid "" "Now the function looks like this after re-indenting (using @kbd{M-x " "vhdl-indent-defun}):" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:774 msgid "" "Custom indentation functions can be as simple or as complex as you like, and " "any syntactic symbol that appears in @code{vhdl-offsets-alist} can have a " "custom indentation function associated with it. Note however that using " "many custom indentation functions may have a performance impact on VHDL " "Mode." msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:779 #, no-wrap msgid "vhdl-special-indent-hook" msgstr "" #. type: vindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:780 #, no-wrap msgid "special-indent-hook @r{(vhdl-)}" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:789 msgid "" "One other variable is available for you to customize VHDL Mode: " "@code{vhdl-special-indent-hook}. This is a standard hook variable that is " "called after every line is indented by VHDL Mode. You can use it to do any " "special indentation or line adjustments your style dictates, such as adding " "extra indentation to the port map clause in a component instantiation, etc. " "Note however, that you should not change @code{point} or @code{mark} inside " "your @code{vhdl-special-indent-hook} functions." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:791 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:792 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:793 #, no-wrap msgid "Syntactic Symbols" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:799 msgid "" "The complete list of recognized syntactic symbols is described in the " "@code{vhdl-offsets-alist} variable. This chapter will provide some examples " "to help clarify these symbols." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:800 #, no-wrap msgid "-open syntactic symbols" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:801 #, no-wrap msgid "-close syntactic symbols" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:806 msgid "" "Most syntactic symbol names follow a general naming convention. When a line " "begins with a @code{begin} or @code{end} keyword, the syntactic symbol will " "contain the suffix @code{-open} or @code{-close} respectively." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:807 #, no-wrap msgid "-intro syntactic symbols" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:808 #, no-wrap msgid "-cont syntactic symbols" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:809 #, no-wrap msgid "-block-intro syntactic symbols" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:816 msgid "" "Usually, a distinction is made between the first line that introduces a " "construct and lines that continue a construct, and the syntactic symbols " "that represent these lines will contain the suffix @code{-intro} or " "@code{-cont} respectively. As a sub-classification of this scheme, a line " "which is the first of a particular block construct will contain the suffix " "@code{-block-intro}." msgstr "" #. type: strong{#1} #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:819 msgid "" " include the name and a brief example of every syntactic symbol " "currently recognized" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:820 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:821 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:822 #, no-wrap msgid "Frequently Asked Questions" msgstr "" #. type: kindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:824 #, no-wrap msgid "C-x h" msgstr "" #. type: kindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:825 #, no-wrap msgid "ESC C-\\" msgstr "" #. type: kindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:826 #, no-wrap msgid "ESC C-q" msgstr "" #. type: kindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:827 #, no-wrap msgid "ESC C-u" msgstr "" #. type: kindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:828 #, no-wrap msgid "RET" msgstr "" #. type: kindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:829 #, no-wrap msgid "LFD" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:830 #, no-wrap msgid "newline-and-indent" msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:834 msgid "@strong{Q.} @emph{How do I re-indent the whole file?}" msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:838 msgid "" "@strong{A.} Visit the file and hit @kbd{C-x h} to mark the whole " "buffer. Then hit @kbd{@key{ESC} C-\\} to re-indent the entire region which " "you've just marked. Or just enter @kbd{M-x vhdl-indent-buffer}." msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:841 msgid "@strong{Q.} @emph{How do I re-indent the entire function?}" msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:845 msgid "" "@strong{A.} Hit @kbd{@key{ESC} C-h} to mark the entire function. Then hit " "@kbd{@key{ESC} C-\\} to re-indent the entire region which you've just " "marked." msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:848 msgid "@strong{Q.} @emph{How do I re-indent the current block?}" msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:852 msgid "" "@strong{A.} First move to the brace which opens the block with " "@kbd{@key{ESC} C-u}, then re-indent that expression with @kbd{@key{ESC} " "C-q}." msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:855 msgid "@strong{Q.} @emph{How do I re-indent the current statement?}" msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:859 msgid "" "@strong{A.} First move to the beginning of the statement with @kbd{@key{ESC} " "a}, then re-indent that expression with @kbd{@key{ESC} C-q}." msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:864 msgid "" "@strong{Q.} @emph{I put @code{(vhdl-set-offset 'statement-cont 0)} in my " "@file{.emacs} file but I get an error saying that @code{vhdl-set-offset}'s " "function definition is void.}" msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:871 msgid "" "@strong{A.} This means that VHDL Mode wasn't loaded into your Emacs session " "by the time the @code{vhdl-set-offset} call was reached, mostly likely " "because VHDL Mode is being autoloaded. Instead of putting the " "@code{vhdl-set-offset} line in your top-level @file{.emacs} file, put it in " "your @code{vhdl-mode-hook}, or simply add the following to the top of your " "@file{.emacs} file:" msgstr "" #. type: example #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:874 #, no-wrap msgid "" "(require 'vhdl-mode)\n" "\n" msgstr "" #. type: quotation #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:879 msgid "See the sample @file{.emacs} file @ref{Sample Init File} for details." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:883 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:884 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:885 #, no-wrap msgid "Getting the latest VHDL Mode release" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:893 msgid "" "The best way to be sure you always have the latest VHDL Mode release is to " "join the @code{vhdl-mode-announce} mailing list. If you are a brave soul, " "and wish to participate in beta testing of new releases of VHDL Mode, you " "may also join the @code{vhdl-mode-victims} mailing list. Send email to the " "maintainer @email{reto@@gnu.org} to join either of these lists." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:896 msgid "" "The official Emacs VHDL Mode Home Page can be found at " "@uref{http://www.iis.ee.ethz.ch/~zimmi/emacs/vhdl-mode.html}." msgstr "" #. type: chapter #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:897 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:898 #, no-wrap msgid "Sample Init File" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:899 #, no-wrap msgid "Sample init file" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:904 msgid "" "Most customizations can be done using the ``Customize'' entry in the VHDL " "Mode menu, which requires no editing of the .emacs file. If you want to " "customize indentation, here you go:" msgstr "" #. type: example #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:909 #, no-wrap msgid "" ";; Here's a sample .emacs file that might help you along the way. Just\n" ";; copy this region and paste it into your .emacs file. You may want to\n" ";; change some of the actual values.\n" "\n" msgstr "" #. type: example #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:920 #, no-wrap msgid "" "(defconst my-vhdl-style\n" " '((vhdl-tab-always-indent . t)\n" " (vhdl-comment-only-line-offset . 4)\n" " (vhdl-offsets-alist . ((arglist-close " ". vhdl-lineup-arglist)\n" " (statement-cont . 0)\n" " (case-alternative . 4)\n" " (block-open . 0)))\n" " (vhdl-echo-syntactic-information-p . t)\n" " )\n" " \"My VHDL Programming Style\")\n" "\n" msgstr "" #. type: example #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:934 #, no-wrap msgid "" ";; Customizations for vhdl-mode\n" "(defun my-vhdl-mode-hook ()\n" " ;; add my personal style and set it for the current buffer\n" " (vhdl-add-style \"PERSONAL\" my-vhdl-style t)\n" " ;; offset customizations not in my-vhdl-style\n" " (vhdl-set-offset 'statement-case-intro '++)\n" " ;; other customizations\n" " (setq tab-width 8\n" " ;; this will make sure spaces are used instead of tabs\n" " indent-tabs-mode nil)\n" " ;; keybindings for VHDL are put in vhdl-mode-map\n" " (define-key vhdl-mode-map \"\\C-m\" 'newline-and-indent)\n" " )\n" "\n" msgstr "" #. type: example #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:936 #, no-wrap msgid "(add-hook 'vhdl-mode-hook 'my-vhdl-mode-hook)\n" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:938 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:939 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:940 #, no-wrap msgid "Limitations and Known Bugs" msgstr "" #. type: itemize #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:945 msgid "Re-indenting large regions or expressions can be slow." msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:953 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:954 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:955 #, no-wrap msgid "Mailing Lists and Submitting Bug Reports" msgstr "" #. type: kindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:957 #, no-wrap msgid "C-c C-b" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:958 #, no-wrap msgid "vhdl-submit-bug-report" msgstr "" #. type: findex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:959 #, no-wrap msgid "submit-bug-report @r{(vhdl-)}" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:960 #, no-wrap msgid "beta testers mailing list" msgstr "" #. type: cindex #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:961 #, no-wrap msgid "announcement mailing list" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:969 msgid "" "To report bugs, use the @kbd{C-c C-b} (@code{vhdl-submit-bug-report}) " "command. This provides vital information I need to reproduce your problem. " "Make sure you include a concise, but complete code example. Please try to " "boil your example down to just the essential code needed to reproduce the " "problem, and include an exact recipe of steps needed to expose the bug. Be " "especially sure to include any code that appears @emph{before} your bug " "example." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:971 msgid "For other help or suggestions, send a message to @email{reto@@gnu.org}." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:976 msgid "" "Send an add message to @email{reto@@gnu.org} to get on the " "@code{vhdl-mode-victims} beta testers list where beta releases of VHDL Mode " "are posted. Note that you shouldn't expect beta releases to be as stable as " "public releases." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:980 msgid "" "There is also an announce only list where the latest public releases of VHDL " "Mode are posted. Send an add message to @email{reto@@gnu.org} to be added " "to this list." msgstr "" #. type: include #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:984 #, no-wrap msgid "doclicense.texi" msgstr "" #. type: unnumbered #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:987 #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:988 #, no-wrap msgid "Concept Index" msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:999 msgid "" "Since all VHDL Mode commands are prepended with the string @samp{vhdl-}, " "each appears under its @code{vhdl-} name and its @code{ " "(vhdl-)} name." msgstr "" #. type: Plain text #: /Users/suzume/Documents/Repositories/Projet OmegaT de Documentation Emacs - #: Sources/doc/misc/vhdl-mode.texi:1017 msgid "" "Since all VHDL Mode variables are prepended with the string @samp{vhdl-}, " "each appears under its @code{vhdl-} name and its @code{ " "(vhdl-)} name." msgstr ""