sunoc/documentation_emacs_test
1
0
Fork 0
forked from brandelune/documentation_emacs
Code Pull Requests Activity
7fb7588f84
documentation_emacs_test/source/misc/vhdl-mode.texi.fr.po

2161 lines
76 KiB
Plaintext
Raw Normal View History

Commit source files
2022-03-08 11:11:57 +01:00
# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 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 <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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 ""
"<TBD> 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-<thing>} name and its @code{<thing> "
"(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-<thing>} name and its @code{<thing> "
"(vhdl-)} name."
msgstr ""
Copy Permalink