new repository

1 files changed, 12 insertions, 0 deletions

diff --git a/devdocs/elisp/basic-faces.html b/devdocs/elisp/basic-faces.html
new file mode 100644
index 00000000..159db119
--- /dev/null
+++ b/devdocs/elisp/basic-faces.html
@@ -0,0 +1,12 @@
+ <h4 class="subsection">Basic Faces</h4>  <p>If your Emacs Lisp program needs to assign some faces to text, it is often a good idea to use certain existing faces or inherit from them, rather than defining entirely new faces. This way, if other users have customized the basic faces to give Emacs a certain look, your program will fit in without additional customization. </p> <p>Some of the basic faces defined in Emacs are listed below. In addition to these, you might want to make use of the Font Lock faces for syntactic highlighting, if highlighting is not already handled by Font Lock mode, or if some Font Lock faces are not in use. See <a href="faces-for-font-lock">Faces for Font Lock</a>. </p> <dl compact> <dt><code>default</code></dt> <dd>
+<p>The default face, whose attributes are all specified. All other faces implicitly inherit from it: any unspecified attribute defaults to the attribute on this face (see <a href="face-attributes">Face Attributes</a>). </p> </dd> <dt><code>bold</code></dt> <dt><code>italic</code></dt> <dt><code>bold-italic</code></dt> <dt><code>underline</code></dt> <dt><code>fixed-pitch</code></dt> <dt><code>fixed-pitch-serif</code></dt> <dt><code>variable-pitch</code></dt> <dd>
+<p>These have the attributes indicated by their names (e.g., <code>bold</code> has a bold <code>:weight</code> attribute), with all other attributes unspecified (and so given by <code>default</code>). </p> </dd> <dt><code>shadow</code></dt> <dd>
+<p>For dimmed-out text. For example, it is used for the ignored part of a filename in the minibuffer (see <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Minibuffer-File.html#Minibuffer-File">Minibuffers for File Names</a> in <cite>The GNU Emacs Manual</cite>). </p> </dd> <dt><code>link</code></dt> <dt><code>link-visited</code></dt> <dd>
+<p>For clickable text buttons that send the user to a different buffer or location. </p> </dd> <dt><code>highlight</code></dt> <dd>
+<p>For stretches of text that should temporarily stand out. For example, it is commonly assigned to the <code>mouse-face</code> property for cursor highlighting (see <a href="special-properties">Special Properties</a>). </p> </dd> <dt><code>match</code></dt> <dt><code>isearch</code></dt> <dt><code>lazy-highlight</code></dt> <dd>
+<p>For text matching (respectively) permanent search matches, interactive search matches, and lazy highlighting other matches than the current interactive one. </p> </dd> <dt><code>error</code></dt> <dt><code>warning</code></dt> <dt><code>success</code></dt> <dd><p>For text concerning errors, warnings, or successes. For example, these are used for messages in <samp>*Compilation*</samp> buffers. </p></dd> </dl><div class="_attribution">
+  <p class="_attribution-p">
+    Copyright &copy; 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br>
+    <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Basic-Faces.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Basic-Faces.html</a>
+  </p>
+</div>