summaryrefslogtreecommitdiff
path: root/devdocs/elisp/font-lookup.html
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2025-08-14 22:58:58 -0500
committerCraig Jennings <c@cjennings.net>2025-08-14 22:58:58 -0500
commit82ba818ff456bcd6d56a06226e3f27e98fbb55c3 (patch)
tree158cfc17b2f644a10f063cb546752cfaae12c97f /devdocs/elisp/font-lookup.html
parent9278ddd4ea1a8b1a4c1edaa8894516e3f48d245b (diff)
downloaddotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.tar.gz
dotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.zip
removing all downloaded devdocs files
Diffstat (limited to 'devdocs/elisp/font-lookup.html')
-rw-r--r--devdocs/elisp/font-lookup.html17
1 files changed, 0 insertions, 17 deletions
diff --git a/devdocs/elisp/font-lookup.html b/devdocs/elisp/font-lookup.html
deleted file mode 100644
index ea2b854a..00000000
--- a/devdocs/elisp/font-lookup.html
+++ /dev/null
@@ -1,17 +0,0 @@
- <h4 class="subsection">Looking Up Fonts</h4> <dl> <dt id="x-list-fonts">Function: <strong>x-list-fonts</strong> <em>name &amp;optional reference-face frame maximum width</em>
-</dt> <dd>
-<p>This function returns a list of available font names that match <var>name</var>. <var>name</var> should be a string containing a font name in either the Fontconfig, GTK+, or XLFD format (see <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Fonts.html#Fonts">Fonts</a> in <cite>The GNU Emacs Manual</cite>). Within an XLFD string, wildcard characters may be used: the ‘<samp>*</samp>’ character matches any substring, and the ‘<samp>?</samp>’ character matches any single character. Case is ignored when matching font names. </p> <p>If the optional arguments <var>reference-face</var> and <var>frame</var> are specified, the returned list includes only fonts that are the same size as <var>reference-face</var> (a face name) currently is on the frame <var>frame</var>. </p> <p>The optional argument <var>maximum</var> sets a limit on how many fonts to return. If it is non-<code>nil</code>, then the return value is truncated after the first <var>maximum</var> matching fonts. Specifying a small value for <var>maximum</var> can make this function much faster, in cases where many fonts match the pattern. </p> <p>The optional argument <var>width</var> specifies a desired font width. If it is non-<code>nil</code>, the function only returns those fonts whose characters are (on average) <var>width</var> times as wide as <var>reference-face</var>. </p>
-</dd>
-</dl> <dl> <dt id="x-family-fonts">Function: <strong>x-family-fonts</strong> <em>&amp;optional family frame</em>
-</dt> <dd>
-<p>This function returns a list describing the available fonts for family <var>family</var> on <var>frame</var>. If <var>family</var> is omitted or <code>nil</code>, this list applies to all families, and therefore, it contains all available fonts. Otherwise, <var>family</var> must be a string; it may contain the wildcards ‘<samp>?</samp>’ and ‘<samp>*</samp>’. </p> <p>The list describes the display that <var>frame</var> is on; if <var>frame</var> is omitted or <code>nil</code>, it applies to the selected frame’s display (see <a href="input-focus">Input Focus</a>). </p> <p>Each element in the list is a vector of the following form: </p> <div class="example"> <pre class="example">[<var>family</var> <var>width</var> <var>point-size</var> <var>weight</var> <var>slant</var>
- <var>fixed-p</var> <var>full</var> <var>registry-and-encoding</var>]
-</pre>
-</div> <p>The first five elements correspond to face attributes; if you specify these attributes for a face, it will use this font. </p> <p>The last three elements give additional information about the font. <var>fixed-p</var> is non-<code>nil</code> if the font is fixed-pitch. <var>full</var> is the full name of the font, and <var>registry-and-encoding</var> is a string giving the registry and encoding of the font. </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/Font-Lookup.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Font-Lookup.html</a>
- </p>
-</div>