Synchronised line endinge with release branch

1 files changed, 178 insertions, 178 deletions

diff --git a/fontconfig/doc/fclangset.fncs b/fontconfig/doc/fclangset.fncs
index d61d9dfef..0a44b38c2 100644
--- a/fontconfig/doc/fclangset.fncs
+++ b/fontconfig/doc/fclangset.fncs
@@ -1,178 +1,178 @@
-/*

- * Copyright © 2007 Keith Packard

- *

- * Permission to use, copy, modify, distribute, and sell this software and its

- * documentation for any purpose is hereby granted without fee, provided that

- * the above copyright notice appear in all copies and that both that copyright

- * notice and this permission notice appear in supporting documentation, and

- * that the name of the copyright holders not be used in advertising or

- * publicity pertaining to distribution of the software without specific,

- * written prior permission.  The copyright holders make no representations

- * about the suitability of this software for any purpose.  It is provided "as

- * is" without express or implied warranty.

- *

- * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,

- * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO

- * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR

- * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,

- * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER

- * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE

- * OF THIS SOFTWARE.

- */

-

-@RET@		FcLangSet *

-@FUNC@		FcLangSetCreate

-@TYPE1@		void

-@PURPOSE@	create a langset object

-@DESC@

-<function>FcLangSetCreate</function> creates a new FcLangSet object.

-@@

-

-@RET@		void

-@FUNC@		FcLangSetDestroy

-@TYPE1@		FcLangSet *			@ARG1@		ls

-@PURPOSE@	destroy a langset object

-@DESC@

-<function>FcLangSetDestroy</function> destroys a FcLangSet object, freeing

-all memory associated with it.

-@@

-

-@RET@		FcLangSet *

-@FUNC@		FcLangSetCopy

-@TYPE1@		const FcLangSet *		@ARG1@		ls

-@PURPOSE@	copy a langset object

-@DESC@

-<function>FcLangSetCopy</function> creates a new FcLangSet object and

-populates it with the contents of <parameter>ls</parameter>.

-@@

-

-@RET@		FcBool

-@FUNC@		FcLangSetAdd

-@TYPE1@		FcLangSet *			@ARG1@		ls

-@TYPE2@		const FcChar8 *			@ARG2@		lang

-@PURPOSE@	add a language to a langset

-@DESC@

-<parameter>lang</parameter> is added to <parameter>ls</parameter>.

-<parameter>lang</parameter> should be of the form Ll-Tt where Ll is a

-two or three letter language from ISO 639 and Tt is a territory from ISO

-3166.

-@@

-

-@RET@		FcBool

-@FUNC@		FcLangSetDel

-@TYPE1@		FcLangSet *			@ARG1@		ls

-@TYPE2@		const FcChar8 *			@ARG2@		lang

-@PURPOSE@	delete a language from a langset

-@DESC@

-<parameter>lang</parameter> is removed from <parameter>ls</parameter>.

-<parameter>lang</parameter> should be of the form Ll-Tt where Ll is a

-two or three letter language from ISO 639 and Tt is a territory from ISO

-3166.

-@@

-

-@RET@		FcLangSet *

-@FUNC@		FcLangSetUnion

-@TYPE1@		const FcLangSet *		@ARG1@		ls_a

-@TYPE2@		const FcLangSet *		@ARG2@		ls_b

-@PURPOSE@	Add langsets

-@DESC@

-Returns a set including only those languages found in either <parameter>ls_a</parameter> or <parameter>ls_b</parameter>.

-@@

-

-@RET@		FcLangSet *

-@FUNC@		FcLangSetSubtract

-@TYPE1@		const FcLangSet *		@ARG1@		ls_a

-@TYPE2@		const FcLangSet *		@ARG2@		ls_b

-@PURPOSE@	Subtract langsets

-@DESC@

-Returns a set including only those languages found in <parameter>ls_a</parameter> but not in <parameter>ls_b</parameter>.

-@@

-

-@RET@		FcLangResult

-@FUNC@		FcLangSetCompare

-@TYPE1@		const FcLangSet *		@ARG1@		ls_a

-@TYPE2@		const FcLangSet *		@ARG2@		ls_b

-@PURPOSE@	compare language sets

-@DESC@

-<function>FcLangSetCompare</function> compares language coverage for

-<parameter>ls_a</parameter> and <parameter>ls_b</parameter>. If they share

-any language and territory pair, this function returns FcLangEqual. If they

-share a language but differ in which territory that language is for, this

-function returns FcLangDifferentTerritory. If they share no languages in

-common, this function returns FcLangDifferentLang.

-@@

-

-@RET@		FcBool

-@FUNC@		FcLangSetContains

-@TYPE1@		const FcLangSet *		@ARG1@		ls_a

-@TYPE2@		const FcLangSet *		@ARG2@		ls_b

-@PURPOSE@	check langset subset relation

-@DESC@

-<function>FcLangSetContains</function> returns FcTrue if

-<parameter>ls_a</parameter> contains every language in

-<parameter>ls_b</parameter>. <parameter>ls_a</parameter> will 'contain' a

-language from <parameter>ls_b</parameter> if <parameter>ls_a</parameter>

-has exactly the language, or either the language or

-<parameter>ls_a</parameter> has no territory.

-@@

-

-@RET@		FcBool

-@FUNC@		FcLangSetEqual

-@TYPE1@		const FcLangSet *		@ARG1@		ls_a

-@TYPE2@		const FcLangSet *		@ARG2@		ls_b

-@PURPOSE@	test for matching langsets

-@DESC@

-Returns FcTrue if and only if <parameter>ls_a</parameter> supports precisely

-the same language and territory combinations as <parameter>ls_b</parameter>.

-@@

-

-@RET@		FcChar32

-@FUNC@		FcLangSetHash

-@TYPE1@		const FcLangSet *		@ARG1@		ls

-@PURPOSE@	return a hash value for a langset

-@DESC@

-This function returns a value which depends solely on the languages

-supported by <parameter>ls</parameter>. Any language which equals

-<parameter>ls</parameter> will have the same result from

-<function>FcLangSetHash</function>. However, two langsets with the same hash

-value may not be equal.

-@@

-

-@RET@		FcLangResult

-@FUNC@		FcLangSetHasLang

-@TYPE1@		const FcLangSet *		@ARG1@		ls

-@TYPE2@		const FcChar8 *			@ARG2@		lang

-@PURPOSE@	test langset for language support

-@DESC@

-<function>FcLangSetHasLang</function> checks whether

-<parameter>ls</parameter> supports <parameter>lang</parameter>. If 

-<parameter>ls</parameter> has a matching language and territory pair,

-this function returns FcLangEqual. If <parameter>ls</parameter> has

-a matching language but differs in which territory that language is for, this

-function returns FcLangDifferentTerritory. If <parameter>ls</parameter> 

-has no matching language, this function returns FcLangDifferentLang.

-@@

-

-@RET@		FcStrSet *

-@FUNC@		FcLangSetGetLangs

-@TYPE1@		const FcLangSet *		@ARG1@		ls

-@PURPOSE@	get the list of languages in the langset

-@DESC@

-Returns a string set of all languages in <parameter>langset</parameter>.

-@@

-

-@RET@		FcStrSet *

-@FUNC@		FcGetLangs

-@TYPE1@		void

-@PURPOSE@	Get list of languages

-@DESC@

-Returns a string set of all known languages.

-@@

-

-@RET@		const FcCharSet *

-@FUNC@		FcLangGetCharSet

-@TYPE1@		const FcChar8 *			@ARG1@		lang

-@PURPOSE@	Get character map for a language

-@DESC@

-Returns the FcCharMap for a language.

-@@

+/*
+ * Copyright © 2007 Keith Packard
+ *
+ * Permission to use, copy, modify, distribute, and sell this software and its
+ * documentation for any purpose is hereby granted without fee, provided that
+ * the above copyright notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting documentation, and
+ * that the name of the copyright holders not be used in advertising or
+ * publicity pertaining to distribution of the software without specific,
+ * written prior permission.  The copyright holders make no representations
+ * about the suitability of this software for any purpose.  It is provided "as
+ * is" without express or implied warranty.
+ *
+ * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
+ * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
+ * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
+ * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+ * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+ * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
+ * OF THIS SOFTWARE.
+ */
+
+@RET@		FcLangSet *
+@FUNC@		FcLangSetCreate
+@TYPE1@		void
+@PURPOSE@	create a langset object
+@DESC@
+<function>FcLangSetCreate</function> creates a new FcLangSet object.
+@@
+
+@RET@		void
+@FUNC@		FcLangSetDestroy
+@TYPE1@		FcLangSet *			@ARG1@		ls
+@PURPOSE@	destroy a langset object
+@DESC@
+<function>FcLangSetDestroy</function> destroys a FcLangSet object, freeing
+all memory associated with it.
+@@
+
+@RET@		FcLangSet *
+@FUNC@		FcLangSetCopy
+@TYPE1@		const FcLangSet *		@ARG1@		ls
+@PURPOSE@	copy a langset object
+@DESC@
+<function>FcLangSetCopy</function> creates a new FcLangSet object and
+populates it with the contents of <parameter>ls</parameter>.
+@@
+
+@RET@		FcBool
+@FUNC@		FcLangSetAdd
+@TYPE1@		FcLangSet *			@ARG1@		ls
+@TYPE2@		const FcChar8 *			@ARG2@		lang
+@PURPOSE@	add a language to a langset
+@DESC@
+<parameter>lang</parameter> is added to <parameter>ls</parameter>.
+<parameter>lang</parameter> should be of the form Ll-Tt where Ll is a
+two or three letter language from ISO 639 and Tt is a territory from ISO
+3166.
+@@
+
+@RET@		FcBool
+@FUNC@		FcLangSetDel
+@TYPE1@		FcLangSet *			@ARG1@		ls
+@TYPE2@		const FcChar8 *			@ARG2@		lang
+@PURPOSE@	delete a language from a langset
+@DESC@
+<parameter>lang</parameter> is removed from <parameter>ls</parameter>.
+<parameter>lang</parameter> should be of the form Ll-Tt where Ll is a
+two or three letter language from ISO 639 and Tt is a territory from ISO
+3166.
+@@
+
+@RET@		FcLangSet *
+@FUNC@		FcLangSetUnion
+@TYPE1@		const FcLangSet *		@ARG1@		ls_a
+@TYPE2@		const FcLangSet *		@ARG2@		ls_b
+@PURPOSE@	Add langsets
+@DESC@
+Returns a set including only those languages found in either <parameter>ls_a</parameter> or <parameter>ls_b</parameter>.
+@@
+
+@RET@		FcLangSet *
+@FUNC@		FcLangSetSubtract
+@TYPE1@		const FcLangSet *		@ARG1@		ls_a
+@TYPE2@		const FcLangSet *		@ARG2@		ls_b
+@PURPOSE@	Subtract langsets
+@DESC@
+Returns a set including only those languages found in <parameter>ls_a</parameter> but not in <parameter>ls_b</parameter>.
+@@
+
+@RET@		FcLangResult
+@FUNC@		FcLangSetCompare
+@TYPE1@		const FcLangSet *		@ARG1@		ls_a
+@TYPE2@		const FcLangSet *		@ARG2@		ls_b
+@PURPOSE@	compare language sets
+@DESC@
+<function>FcLangSetCompare</function> compares language coverage for
+<parameter>ls_a</parameter> and <parameter>ls_b</parameter>. If they share
+any language and territory pair, this function returns FcLangEqual. If they
+share a language but differ in which territory that language is for, this
+function returns FcLangDifferentTerritory. If they share no languages in
+common, this function returns FcLangDifferentLang.
+@@
+
+@RET@		FcBool
+@FUNC@		FcLangSetContains
+@TYPE1@		const FcLangSet *		@ARG1@		ls_a
+@TYPE2@		const FcLangSet *		@ARG2@		ls_b
+@PURPOSE@	check langset subset relation
+@DESC@
+<function>FcLangSetContains</function> returns FcTrue if
+<parameter>ls_a</parameter> contains every language in
+<parameter>ls_b</parameter>. <parameter>ls_a</parameter> will 'contain' a
+language from <parameter>ls_b</parameter> if <parameter>ls_a</parameter>
+has exactly the language, or either the language or
+<parameter>ls_a</parameter> has no territory.
+@@
+
+@RET@		FcBool
+@FUNC@		FcLangSetEqual
+@TYPE1@		const FcLangSet *		@ARG1@		ls_a
+@TYPE2@		const FcLangSet *		@ARG2@		ls_b
+@PURPOSE@	test for matching langsets
+@DESC@
+Returns FcTrue if and only if <parameter>ls_a</parameter> supports precisely
+the same language and territory combinations as <parameter>ls_b</parameter>.
+@@
+
+@RET@		FcChar32
+@FUNC@		FcLangSetHash
+@TYPE1@		const FcLangSet *		@ARG1@		ls
+@PURPOSE@	return a hash value for a langset
+@DESC@
+This function returns a value which depends solely on the languages
+supported by <parameter>ls</parameter>. Any language which equals
+<parameter>ls</parameter> will have the same result from
+<function>FcLangSetHash</function>. However, two langsets with the same hash
+value may not be equal.
+@@
+
+@RET@		FcLangResult
+@FUNC@		FcLangSetHasLang
+@TYPE1@		const FcLangSet *		@ARG1@		ls
+@TYPE2@		const FcChar8 *			@ARG2@		lang
+@PURPOSE@	test langset for language support
+@DESC@
+<function>FcLangSetHasLang</function> checks whether
+<parameter>ls</parameter> supports <parameter>lang</parameter>. If 
+<parameter>ls</parameter> has a matching language and territory pair,
+this function returns FcLangEqual. If <parameter>ls</parameter> has
+a matching language but differs in which territory that language is for, this
+function returns FcLangDifferentTerritory. If <parameter>ls</parameter> 
+has no matching language, this function returns FcLangDifferentLang.
+@@
+
+@RET@		FcStrSet *
+@FUNC@		FcLangSetGetLangs
+@TYPE1@		const FcLangSet *		@ARG1@		ls
+@PURPOSE@	get the list of languages in the langset
+@DESC@
+Returns a string set of all languages in <parameter>langset</parameter>.
+@@
+
+@RET@		FcStrSet *
+@FUNC@		FcGetLangs
+@TYPE1@		void
+@PURPOSE@	Get list of languages
+@DESC@
+Returns a string set of all known languages.
+@@
+
+@RET@		const FcCharSet *
+@FUNC@		FcLangGetCharSet
+@TYPE1@		const FcChar8 *			@ARG1@		lang
+@PURPOSE@	Get character map for a language
+@DESC@
+Returns the FcCharMap for a language.
+@@