Commit Graph

229 Commits

Author SHA1 Message Date
Behdad Esfahbod b5617e636c More doc typo fixes 2011-03-14 18:23:56 -03:00
Behdad Esfahbod 6c7915c105 Mark constant strings as constant
Fixes a few compiler warnings in fcxml.c and makes it clear that they
should not be freed.
2011-03-14 18:21:32 -03:00
Brad Hards 7baa20c759 Documentation fixes 2011-03-11 19:43:42 -03:00
Behdad Esfahbod e63f90ce74 Doc nit 2010-12-28 02:58:16 -06:00
Behdad Esfahbod 549c9962a4 Allow editing charset and lang in target="scan"
Merge commit 'fa269cf812ee304534b0e4c44662202496008db0'

Fixes:
Bug 31969 - Can't modify charset in target="scan"
Bug 23758 - Can't modify lang in target="scan"
2010-12-28 02:51:10 -06:00
Behdad Esfahbod 2a6b235ff6 Make most generated-files cross-compiling-safe
By simply including a copy in the tarball.

Remains fc-arch which is trickier.
2010-12-27 13:20:47 -06:00
Akira TAGOH fa269cf812 add some documents 2010-12-09 11:57:24 +09:00
Akira TAGOH 51e352a1bd add some document for range and charset. 2010-12-09 11:32:26 +09:00
Behdad Esfahbod 5aaf466d38 Cleanup copyright notices to replace "Keith Packard" with "the author(s)" 2010-11-10 16:45:42 -05:00
Behdad Esfahbod 52960d05eb Add new public API: FcCharSetDelChar() 2010-09-21 13:14:41 -04:00
Behdad Esfahbod 2e375b6894 More doc typo fixes 2010-02-14 20:27:22 -05:00
Behdad Esfahbod 77be30cb9f Fix doc typo 2010-02-14 20:20:00 -05:00
Behdad Esfahbod 36ae1d9563 Clarify default confdir and cachedir better.
Also remove --with-docdir.  It can be set by setting docdir variable.
2009-11-09 13:17:17 -05:00
Behdad Esfahbod 273e22c71f Hardcode /etc/fonts instead of @CONFDIR@ in docs (#22911)
We distribute the docs, so it makes little sense to distribute with
@CONFDIR@ replaced.  Until we find a better solution, I've hardcoded
/etc/fonts now.
2009-07-27 15:07:12 -04:00
Behdad Esfahbod 21384990ff [doc] Add ~/fonts.conf.d to user docs 2009-07-27 14:50:44 -04:00
Behdad Esfahbod caeea376da Document FcPatternFormat() format 2009-03-13 19:06:43 -04:00
Behdad Esfahbod 3074a73b41 Replace 'KEITH PACKARD' with 'THE AUTHOR(S)' in license text in all files 2009-03-13 17:59:28 -04:00
Behdad Esfahbod d62b85af21 [fclang] Implement FcLangSetGetLangs() (#18846) 2009-02-15 14:13:34 -08:00
Behdad Esfahbod 8c31a2434d [fcformat] Add element filtering and deletion
The filtering, '%{+elt1,elt2,elt3{subexpr}}' will evaluate subexpr
with a pattern only having the listed elements from the surrounding
pattern.

The deletion, '%{-elt1,elt2,elt3{subexpr}}' will evaluate subexpr
with a the surrounding pattern sans the listed elements.
2009-02-15 13:40:26 -08:00
Behdad Esfahbod c493c3b770 [fcformat] Add support for width modifiers
One can do '%30{family}' for example.  Or '%-30{family}' for the
left-aligned version.
2009-02-15 13:40:25 -08:00
Karl Tomlinson 575ee6cddd Change FcCharSetMerge API
To only work on writable charsets.  Also, return a bool indicating whether
the merge changed the charset.

Also changes the implementation of FcCharSetMerge and FcCharSetIsSubset
2009-02-15 13:40:18 -08:00
Behdad Esfahbod 98d765a53b Cleanup all manpage.* files
Recent doc2man generates files called manpage.log.  This was breaking build.
2009-02-13 16:55:08 -08:00
Behdad Esfahbod 6bffe1a95b Add fc-scan too that runs FcFileScan/FcDirScan
This is quite similar to fc-query, but calling FcFileScan/FcDirScan instead
of FcFreeTypeQuery.
2009-02-13 16:54:06 -08:00
Behdad Esfahbod 25a09eb9bf Don't use FcCharSetCopy in FcCharSetMerge
The Copy function is actually a ref, not real copy.
2009-02-13 16:54:06 -08:00
Behdad Esfahbod d230cf144f Make FcCharSetMerge() public
That's needed for apps to be abled to do pruning themselves without
the performance penalty of recreating new charsets all the time.
2009-02-13 16:54:05 -08:00
Behdad Esfahbod 3b725d0a31 [doc] Note that fontset returned by FcConfigGetFonts should not be modified 2009-02-13 16:54:05 -08:00
Behdad Esfahbod 0c93b91db0 Implement FcPatternFormat and use it in cmdline tools (bug #17107)
Still need to add more features, but the API is there, and used
by cmdline tools with -f or --format.
2009-02-13 16:54:04 -08:00
Alexey Khoroshilov 6ca36812b4 Use human-readable file names in the docs (bug #16278) 2009-02-13 16:54:02 -08:00
Behdad Esfahbod 1c7f4de80c Fix two more doc typos 2009-02-13 16:54:00 -08:00
Behdad Esfahbod 8072f4b130 Document how to free return value of FcNameUnparse() 2009-02-13 16:54:00 -08:00
Behdad Esfahbod 241fbde1ab Add FcConfigReference() (#17124) 2009-02-13 16:53:59 -08:00
Behdad Esfahbod 03dcaaa08f Document when config can be NULL (#17105)
Note that this also fixes a bug with FcFontList() where previously
it was NOT checking whether the config is up-to-date.  May want to
keep the old behavior and document that ScanInterval is essentially
unused internally (FcFontSetList uses it, but we can remove that
too).
2009-02-13 16:53:59 -08:00
Behdad Esfahbod 74e16ceeea Fix docs re 'orig' argument of FcPatternBuild and family
Now call it 'p' or 'pattern', since it's modified in place.
There is no copying.
2009-02-13 16:53:57 -08:00
Behdad Esfahbod bb65f58f63 [doc] Fix signature of FcConfigHome()
We should write a test to automatically cross-check signatures
from public headers to docs.
2009-02-13 16:53:57 -08:00
Behdad Esfahbod e690fbb20e Get rid of $Id$ tags 2009-02-13 16:53:57 -08:00
Behdad Esfahbod 3042050954 [doc] Document that a zero rescanInterval disables automatic checks (#17103) 2009-02-13 16:53:57 -08:00
Behdad Esfahbod 41fc0fe68d Add FcPatternFilter() (#13016) 2009-02-13 16:53:56 -08:00
Behdad Esfahbod e6f14d3c51 [doc] Add const decorator for FcPatternDuplicate() 2009-02-13 16:53:56 -08:00
Behdad Esfahbod 77c0d8bce8 Add fc-query (#13019) 2009-02-13 16:53:56 -08:00
Behdad Esfahbod 2e08e0f243 [doc] Fix signatures of FcPatternGetFTFace and FcPatternGetLangSet (#16272) 2009-02-13 16:53:55 -08:00
Behdad Esfahbod b21bea3731 [doc] Fix inaccuracy in FcFontRenderPrepare docs (#16985) 2009-02-13 16:53:54 -08:00
Benjamin Close f7364e6273 Remove build manpage logfile if it exists 2009-02-12 10:23:40 +10:30
Alexey Khoroshilov 0faca4ff82 Fix FcStrDirname documentation. (bug 16068)
Description of FcStrDirname is absent in the official documentation of
fontconfig-2.5.92. At the same time the source documentation contains
description of the function.

The problem is a consequence of a misprint in the format of the source
documentation file 'fcstring.fncs'. The finish mark of description of the
previous function is absent.
2008-05-24 15:44:18 -07:00
Sylvain Pasche 53aec11107 Fontconfig options for freetype sub-pixel filter configuration
David Turner has modified FreeType to be able to render sub-pixel decimated
glyphs using different methods of filtering. Fontconfig needs new
configurables to support selecting these new filtering options. A patch
follows that would correspond to one available for Cairo in bug 10301.
2008-05-03 19:33:45 -07:00
Keith Packard 1315db01b6 Revert "Remove fcprivate.h, move the remaining macros to fcint.h."
This reverts commit b607922909.

Conflicts:

	src/Makefile.am

Xft still uses the macros that are in fcprivate.h. Document those macros and
include fcprivate.h in the published header files.
2007-11-13 15:48:30 -08:00
Keith Packard eaf4470a46 Document that FcConfigGetFonts returns the internal fontset (bug 13197)
FcConfigGetFonts returns the internal font set used by the library which
must not be freed by the application or 'bad things' will happen.
2007-11-13 15:16:58 -08:00
Keith Packard 3fb38716ae Document that Match calls FcFontRenderPrepare (bug 13162).
The behaviour of FcFontMatch and FcFontSetMatch is hard to understand without
knowing that they call FcFontRenderPrepare.
2007-11-13 15:11:35 -08:00
Keith Packard fab44f3cb6 Document several function return values (Bug 13145).
Several functions had no indication of what the return value would be,
mostly these were allocation failure returns.
2007-11-13 14:58:39 -08:00
Keith Packard ed7955a58f Fix parallel build in doc directory.
docbook2man has fixed output file names; place output in a subdirectory to
avoid collisions.
2007-11-05 16:08:55 -08:00
Behdad Esfahbod cf223cc7bc Add FcGetLangs() and FcLangGetCharSet(). 2007-11-05 15:29:44 -05:00
Behdad Esfahbod 811995b79d Fix trivial bugs in edit-sgml.c 2007-11-05 15:29:03 -05:00
Keith Packard dc7b6f1d79 Link new function documentation into the fontconfig-devel.sgml 2007-11-03 23:42:32 -07:00
Keith Packard dac27f2f1a Formatting syntax mistake in doc/fclangset.fncs.
<parameter>ls</function> needed to be <parameter>ls</parameter>.
2007-11-03 23:41:38 -07:00
Keith Packard 9bfb41ffef Generate fccache.sgml, fcdircache.sgml and fclangset.sgml.
Just adding the .fncs versions doesn't get these files generated.
2007-11-03 23:23:55 -07:00
Keith Packard bfdc0047c6 Fix formatting syntax in doc/fccache.fncs 2007-11-03 23:23:09 -07:00
Keith Packard f2772d6b45 Replace incorrect documentation uses of 'char' with 'FcChar8' (bug 13002). 2007-11-03 23:03:11 -07:00
Keith Packard b4a3e83412 Remove references to FcConfigParse and FcConfigLoad.
These functions no longer exist.
2007-11-03 22:53:12 -07:00
Keith Packard 7c6939793b Update documentation for stale FcConfigGetConfig function.
The old per-user cache filename is no longer used.
2007-11-03 22:39:54 -07:00
Keith Packard 026fe895e4 Update documentation for FcStrCopyFilename (bug 12964).
FcStrCopyFilename constructs a canonical path for any argument, including
expanding leading ~ and editing '.' and '..' elements out of the resulting
path.
2007-11-03 22:31:16 -07:00
Keith Packard a190678e3c Document previously undocumented functions. (bug 12963) 2007-11-03 22:23:28 -07:00
Keith Packard 9a54f8a194 Verify documentation covers exposed symbols.
Add check-missing-doc script to make sure the documentation matches the
complete list of symbols exported from the header files before release.
2007-11-03 22:01:33 -07:00
Keith Packard b868a14473 Track line numbers in sgml edit tool input.
Errors in the documentation can be hard to find unless the tool outputs the
line number where the problem exists.
2007-11-03 21:55:39 -07:00
Keith Packard 2ddce88cde Document skipping of fonts from FcFileScan/FcDirScan.
FcFileScan and FcDirScan will skip fonts under direction of the
configuration and default fontconfig policy.
2007-11-03 13:44:59 -07:00
Keith Packard 5d82c4c85d Correct documentation for FcConfigUptoDate (bug 12948).
FcConfigUptoDate only checks whether files have been modified since the
configuration was created. Any changes to the configuration through the API
since then are not considered.
2007-11-03 13:26:16 -07:00
Keith Packard 910db318ae Correct documentation for FcAtomicLock (Bug 12947).
FcAtomicLock can only be called once from any process.
2007-11-03 13:05:25 -07:00
Keith Packard 89d6119c02 A few fixups for make distcheck 2007-10-25 15:19:14 -07:00
Keith Packard 28a4ea7f71 Fix parallel build in fontconfig/docs (bug 10481). 2007-10-25 01:09:11 -07:00
Keith Packard 61139cf638 Spelling errors in documentation. (bug 10879).
Thanks to David <ssdk@ispras.ru> for spotting these.
2007-10-25 00:49:19 -07:00
Keith Packard 26437d4924 FcConfigParseAndLoad doc was missing the last param.
Typo lost the last param to this function.
2007-10-18 08:56:42 -07:00
Keith Packard 61895ed16c Add space between type and formal in devel man pages (bug 8935)
Most parameters are pointers and have '*' in the type; for those
which do not, use '%' to mark where a space needs to be inserted.
2006-12-02 15:06:13 -08:00
Peter Breitenlohner b1aa20098f Use <literal> instead of <sgmltag> when documenting fonts.conf. Bug 8935. 2006-12-02 14:28:03 -08:00
Peter Breitenlohner 2cae0512cd A VPATH build of fontconfig-2.4.1 fails for various reasons. Bug 8933.
VPATH builds without doctools breaks as it cannot find the distributed
pre-formatted documentation.
2006-12-02 14:18:11 -08:00
Keith Packard 72ffe6536a Add FcFreeTypeQueryFace external API. Bug #7311.
Expose ability to build an FcPattern directly from an FT_Face
object.
2006-12-02 13:22:27 -08:00
Keith Packard 6262fefe54 Remove documentation for non-existant FcConfigNormalizeFontDir.
FcConfigNormalizeFontDir was present in some of the 2.3.9x release but not
in the final 2.4 release. However, the documentation persisted.
2006-09-17 13:50:31 -07:00
Keith Packard 34227592c2 Remove all .cvsignore files 2006-09-03 16:27:09 -07:00
Keith Packard c2c6976d1a Add FcMatchScan to resolve Delicious font matching issues (bug #6769)
The Delicious family includes one named Delicious Heavy, a bold variant
which is unfortunately marked as having normal weight. Because the family
name is 'Delicious', fontconfig accidentally selects this font instead of
the normal weight variant. The fix here rewrites the scanned data by running
the scanned pattern through a new substitution sequence tagged with
<match target=scan>; a sample for the Delicious family is included to
demonstrate how it works (and fix Delicious at the same time).

Also added was a new match predicate -- the 'decorative' predicate which is
automatically detected in fonts by searching style names for key decorative
phrases like SmallCaps, Shadow, Embosed and Antiqua. Suggestions for
additional decorative key words are welcome. This should have little effect
on font matching except when two fonts share the same characteristics except
for this value.
2006-09-02 17:52:12 -07:00
Keith Packard 5cafbd4da0 Document FC_DEBUG values (bug 6393). Document name \ escape syntax.
Limited FC_DEBUG documentation (just shows values and vague idea of what
they're related to). Also document \ escape syntax for font names, including
how family name and values have different escape requirements.
2006-09-01 22:04:52 -07:00
Patrick Lam af2ad236f0 Survive missing docbook2pdf.
reviewed by: plam
2006-04-11 05:08:26 +00:00
Patrick Lam 788c4af232 Make 'make distcheck' work with automake 1.6.3.
reviewed by: plam
2006-02-05 04:11:08 +00:00
Patrick Lam af7a965f94 Fix world's tiniest typo in code example.
reviewed by: plam
2006-01-30 04:51:22 +00:00
Patrick Lam 971cf18018 Add documentation for FcConfigNormalizeFontDir.
Write directory information to global caches to fix make check (reported by
    Ronny V. Vindenes). This changes the global cache format again.
2006-01-30 04:27:53 +00:00
Patrick Lam e9fd3c069a Fix version of .cache file (currently 1 -> currently 2). Reported by Jim
Osborn.
2006-01-02 17:13:48 +00:00
Patrick Lam ced3f0a0ab Fix problem dating back at least to 2.3.2 where globs weren't being applied
to patterns loaded from a cache.
Fix some obvious spelling mistakes.
2005-11-29 00:14:42 +00:00
Patrick Lam 67accef4d3 Fix more gcc4 warnings:
- Cast sizeof to int, to shut up signedness warnings in comparison.
- Add consts where appropriate.
reviewed by: Patrick Lam <plam@mit.edu>
2005-09-22 23:45:53 +00:00
Patrick Lam 8245771d5a Merge with HEAD and finish the GCC 4 cleanups (no more warnings!) 2005-09-11 02:16:09 +00:00
Keith Packard dc2e06ab07 Ignore more build detritus
Add debian package construction stuff.
Update to newer versions of these tools
Get library manuals to build again (we love automake).
Update debian build system to switch maintainers and deal with 2.3
    functionality
2005-03-03 01:59:28 +00:00
Keith Packard 0c009d2b6d Generate and install PDF versions of the manuals
Fix formatting
Add missing exported functions, fix data types
Add missing pattern elements.
Add missing pattern elements. Document conf.d usage, clarify available
    orthography list. Fix some config file attributes. Complete list of
    constants.
Mark FC_SOURCE deprecated.
Don't set FC_SOURCE any longer.
2005-03-01 20:36:48 +00:00
Keith Packard d8ae9c9219 Add SEE ALSO section (bug 2085)
Cross compiling fixes (bug 280)
reviewed by: Keith Packard <keithp@keithp.com>
2005-01-13 18:31:50 +00:00
Keith Packard 46b51147d1 Change files from ISO-Latin-1 to UTF-8 2004-12-07 01:14:46 +00:00
Keith Packard 2d9c79c049 Change default set of fonts to include all of /usr/X11R6/lib/X11/fonts (or
wherever the X fonts are located).
Document new <include>directory-name</include> semantics
add <include ignore_missing="yes">conf.d</include>
Add selectfont to ignore bitmap fonts, add comment for selectfont which
    accepts bitmap fonts.
Allow <include> configuration elements to reference directories. Parse and
    load all files of the form [0-9]* in sorted order.
2004-12-05 05:03:52 +00:00
Keith Packard dbf68dd5fe Fix typo.
Add detection for font capabilities (bug #105)
reviewed by: Keith Packard <keithp@keithp.com>
2004-12-04 22:06:52 +00:00
Keith Packard 4f27c1c0a3 Move existing fonts.conf to fonts.conf.bak
Add detection of iconv
Document new selectfont elements
Switch to UTF-8 in comment
Add fullname, and family/style/fullname language entries
Respect selectfont/*/glob
Add support for selectfont
Add multi-lingual family/style/fullname support
Expose FcListPatternMatchAny (which selectfont/*/pattern uses)
Add new FcPatternRemove/FcPatternAppend. FcObjectStaticName stores computed
    pattern element names which are required to be static.
2004-12-04 19:41:10 +00:00
Keith Packard 408dd9c07a Switch to FreeType 2.1.7 style includes. Bug #150.
reviewed by: Keith Packard <keithp@keithp.com>
2003-11-18 07:53:04 +00:00
Keith Packard 4cbc3ee8fe Yet more cleanups to finish getting 'make distcheck' working This has been
tested to ensure that it even works from a _build directory.
2003-10-27 10:44:13 +00:00
Keith Packard 394b2bf046 Attempts to fix 'make distcheck' work. Things are progressing pretty well,
but there are still failures long into the process dealing with docs
    (as always).
The big changes here are mostly to make $(srcdir) != "." work correctly,
    fixing the docbook related sections and fc-lang were particularily
    tricky. Docbook refuses to load system entities from anywhere other
    than where the original .sgml file was located, so no luck looking in
    "." for the configure-generated version.sgml and confdir.sgml files.
fc-lang needed help finding .orth files; added a -d option to set the
    directory as the least evil of many options.
Now to go use a faster machine and try and wring out the last issues.
2003-10-27 06:30:29 +00:00
Keith Packard e99043ac77 Include confdir.sgml.in in EXTRA_DIST 2003-10-26 16:45:23 +00:00
Noah Levitt a05d257fb3 Add new spacing value FC_DUAL (dual-width, as some CJK fonts). (bug #111)
When checking for monospace and dual-width fonts, allow roughly a 3%
    variance in the advances.
2003-09-06 19:40:41 +00:00
Carl Worth 34cd0514a2 Added new FcFini function for cleaning up all memory. Fixed a few memory
leaks. fc-list now calls FcFini, (and is now leak-free according to
    valgrind)
2003-08-15 19:45:20 +00:00
Keith Packard 2b45ef3a8a Bug 75: dont build docs unless docbook is available. Dont install docs
unless they are pre-built or buildable
2003-06-17 18:28:20 +00:00
Keith Packard 7d5c134a0a Oops. Missing newline in .cvsignore 2003-04-23 04:45:39 +00:00
Keith Packard 8c87b4293f Fix docs to close sgml tags 2003-04-23 04:09:28 +00:00
Keith Packard c92926bf65 Add confdir.sgml to .cvsignore 2003-04-23 04:06:18 +00:00
Keith Packard f946755cdb Use CONFDIR instead of SYSCONFDIR/fonts in manual. Use awk to strip
trailing newline instead of leaving CVS file without a newline (which
    will break at some point)
2003-04-23 04:05:58 +00:00
Noah Levitt 8b290c5476 Got rid of the newline at the end of the file. It's yucky but, I'm not sure
how else to get rid of the newline in the output.
2003-04-23 00:40:24 +00:00
Noah Levitt 4b4f42ab58 Getting closer to fixing /etc/fonts hard-coding. 2003-04-23 00:08:03 +00:00
Noah Levitt 27de1f430a Testing syncmail yet again. 2003-04-22 23:34:50 +00:00
Colin Walters 12d49d3cf4 Remove some unused variables, and initialize some other ones so gcc doesn't
warn us.
2003-04-17 17:43:04 +00:00
Keith Packard cc30f9ca54 remove -u option to docbook2man which was trashing the .html file 2003-04-08 05:00:25 +00:00
Keith Packard ddde1797a9 strtod under some locales requires digits before the decimal 2003-03-20 02:01:01 +00:00
Keith Packard dcd1f27185 add version.sgml to .cvsignore 2003-03-07 20:51:17 +00:00
Keith Packard ae2c294364 Add version number to user doc 2003-03-07 20:50:44 +00:00
Keith Packard fddb839bba Add version number to documentation 2003-03-07 20:45:43 +00:00
Keith Packard 4484582eba wasnt rebuilding most of the docs 2003-03-07 20:45:20 +00:00
Keith Packard bdc0fd5434 get manuals to install with automake-1.4 2003-03-07 20:03:23 +00:00
Keith Packard 164301051d Create fontconfig-user.html 2003-03-07 19:41:34 +00:00
Keith Packard 251c36c1b3 Add more to .cvsignore 2003-03-07 19:39:57 +00:00
Keith Packard b219ac6b99 Make documentation build 2003-03-07 19:37:16 +00:00
Keith Packard 39381776a4 Finish reformatting developer documentation 2003-03-07 19:01:41 +00:00
Keith Packard 90bdcf6051 Add copyright 2003-03-07 08:52:27 +00:00
Keith Packard 2df0c66230 Use <parameter> tags. Add copyrights 2003-03-07 08:51:14 +00:00
Keith Packard bfc2dc3ac4 Add lots more function documentation 2003-03-07 08:44:32 +00:00
Keith Packard 22671e2551 Rework documentation to build man pages for each function 2003-03-07 07:12:51 +00:00
Keith Packard 5e1f56b567 Add func doc creation program edit-sgml 2003-03-07 06:17:36 +00:00
Keith Packard 7b94ae21fc Add .cvsignore 2003-03-04 00:19:09 +00:00
Owen Taylor 22dc6fc6db Sun Mar 2 14:16:17 2003 Owen Taylor <otaylor@redhat.com>
fontconfig.spec.in: Improvements from Red Hat spec file.
{fc-lang,fc-cache,fc-list}/Makefile.am: Add man pages.
docs/*.sgml: SGML fixes.
2003-03-03 01:13:11 +00:00
Keith Packard 9238fc061d Add --disable-docs flag 2003-03-01 05:21:02 +00:00
Keith Packard 0da305f7f8 Switch to docbook and split documentation into pieces 2003-03-01 03:06:37 +00:00
Keith Packard 584ac89a01 Reformat documentation into sgml for docbook, split into user/devel guides 2003-03-01 02:23:52 +00:00
Keith Packard 24330d27f8 Initial revision 2002-02-14 23:34:13 +00:00