← Back to branch summary

~ubuntu-branches/ubuntu/vivid/pango1.0/vivid-proposed

« back to all changes in this revision

Viewing changes to docs/html/pango-Scripts-and-Languages.html

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2014-02-24 12:14:07 UTC
  • mfrom: (1.6.8)
  • Revision ID: package-import@ubuntu.com-20140224121407-qwdtn35328dj7yea
Tags: 1.36.2-2
* Copyright cleanups (thanks Thorsten Alteholz)
  + harfbuzz isn't shipped here any more; remove mention of it
  + mini-fribidi is LGPL-2.1+
  + test/GraphemeBreakTest.txt is under the "Unicode License" (see package
    unicode-data).

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/html/pango-Scripts-and-Languages.html
79
79
<p>
80
80
The functions in this section are used to identify the writing
81
81
system, or <em class="firstterm">script</em> of individual characters
82
 
and of ranges within a larger text string.
83
 
</p>
 
82
and of ranges within a larger text string.</p>
84
83
</div>
85
84
<div class="refsect1">
86
85
<a name="pango-Scripts-and-Languages.details"></a><h2>Details</h2>
198
197
Note that new types may be added in the future. Applications should be ready
199
198
to handle unknown values.  This enumeration is interchangeable with
200
199
<a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#GUnicodeScript"><span class="type">GUnicodeScript</span></a>.  See <a class="ulink" href="http://www.unicode.org/reports/tr24/" target="_top">Unicode Standard Annex
201
 
#24: Script names</a>.
202
 
</p>
 
200
#24: Script names</a>.</p>
203
201
<div class="variablelist"><table border="0" class="variablelist">
204
202
<colgroup>
205
203
<col align="left" valign="top">
219
217
<tr>
220
218
<td><p><a name="PANGO-SCRIPT-INHERITED:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_INHERITED</code></span></p></td>
221
219
<td>a mark glyph that takes its script from the
222
 
  base glyph to which it is attached
 
220
base glyph to which it is attached
223
221
</td>
224
222
</tr>
225
223
<tr>
226
224
<td><p><a name="PANGO-SCRIPT-ARABIC:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_ARABIC</code></span></p></td>
227
 
<td>    Arabic
 
225
<td>Arabic
228
226
</td>
229
227
</tr>
230
228
<tr>
234
232
</tr>
235
233
<tr>
236
234
<td><p><a name="PANGO-SCRIPT-BENGALI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BENGALI</code></span></p></td>
237
 
<td>    Bengali
 
235
<td>Bengali
238
236
</td>
239
237
</tr>
240
238
<tr>
244
242
</tr>
245
243
<tr>
246
244
<td><p><a name="PANGO-SCRIPT-CHEROKEE:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CHEROKEE</code></span></p></td>
247
 
<td>    Cherokee
 
245
<td>Cherokee
248
246
</td>
249
247
</tr>
250
248
<tr>
251
249
<td><p><a name="PANGO-SCRIPT-COPTIC:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_COPTIC</code></span></p></td>
252
 
<td>    Coptic
 
250
<td>Coptic
253
251
</td>
254
252
</tr>
255
253
<tr>
256
254
<td><p><a name="PANGO-SCRIPT-CYRILLIC:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CYRILLIC</code></span></p></td>
257
 
<td>    Cyrillic
 
255
<td>Cyrillic
258
256
</td>
259
257
</tr>
260
258
<tr>
261
259
<td><p><a name="PANGO-SCRIPT-DESERET:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_DESERET</code></span></p></td>
262
 
<td>    Deseret
 
260
<td>Deseret
263
261
</td>
264
262
</tr>
265
263
<tr>
266
264
<td><p><a name="PANGO-SCRIPT-DEVANAGARI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_DEVANAGARI</code></span></p></td>
267
 
<td>    Devanagari
 
265
<td>Devanagari
268
266
</td>
269
267
</tr>
270
268
<tr>
271
269
<td><p><a name="PANGO-SCRIPT-ETHIOPIC:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_ETHIOPIC</code></span></p></td>
272
 
<td>    Ethiopic
 
270
<td>Ethiopic
273
271
</td>
274
272
</tr>
275
273
<tr>
276
274
<td><p><a name="PANGO-SCRIPT-GEORGIAN:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_GEORGIAN</code></span></p></td>
277
 
<td>    Georgian
 
275
<td>Georgian
278
276
</td>
279
277
</tr>
280
278
<tr>
281
279
<td><p><a name="PANGO-SCRIPT-GOTHIC:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_GOTHIC</code></span></p></td>
282
 
<td>    Gothic
 
280
<td>Gothic
283
281
</td>
284
282
</tr>
285
283
<tr>
286
284
<td><p><a name="PANGO-SCRIPT-GREEK:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_GREEK</code></span></p></td>
287
 
<td>    Greek
 
285
<td>Greek
288
286
</td>
289
287
</tr>
290
288
<tr>
291
289
<td><p><a name="PANGO-SCRIPT-GUJARATI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_GUJARATI</code></span></p></td>
292
 
<td>    Gujarati
 
290
<td>Gujarati
293
291
</td>
294
292
</tr>
295
293
<tr>
296
294
<td><p><a name="PANGO-SCRIPT-GURMUKHI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_GURMUKHI</code></span></p></td>
297
 
<td>    Gurmukhi
 
295
<td>Gurmukhi
298
296
</td>
299
297
</tr>
300
298
<tr>
301
299
<td><p><a name="PANGO-SCRIPT-HAN:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_HAN</code></span></p></td>
302
 
<td>    Han
 
300
<td>Han
303
301
</td>
304
302
</tr>
305
303
<tr>
306
304
<td><p><a name="PANGO-SCRIPT-HANGUL:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_HANGUL</code></span></p></td>
307
 
<td>    Hangul
 
305
<td>Hangul
308
306
</td>
309
307
</tr>
310
308
<tr>
311
309
<td><p><a name="PANGO-SCRIPT-HEBREW:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_HEBREW</code></span></p></td>
312
 
<td>    Hebrew
 
310
<td>Hebrew
313
311
</td>
314
312
</tr>
315
313
<tr>
316
314
<td><p><a name="PANGO-SCRIPT-HIRAGANA:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_HIRAGANA</code></span></p></td>
317
 
<td>    Hiragana
 
315
<td>Hiragana
318
316
</td>
319
317
</tr>
320
318
<tr>
321
319
<td><p><a name="PANGO-SCRIPT-KANNADA:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_KANNADA</code></span></p></td>
322
 
<td>    Kannada
 
320
<td>Kannada
323
321
</td>
324
322
</tr>
325
323
<tr>
326
324
<td><p><a name="PANGO-SCRIPT-KATAKANA:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_KATAKANA</code></span></p></td>
327
 
<td>    Katakana
 
325
<td>Katakana
328
326
</td>
329
327
</tr>
330
328
<tr>
331
329
<td><p><a name="PANGO-SCRIPT-KHMER:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_KHMER</code></span></p></td>
332
 
<td>    Khmer
 
330
<td>Khmer
333
331
</td>
334
332
</tr>
335
333
<tr>
336
334
<td><p><a name="PANGO-SCRIPT-LAO:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LAO</code></span></p></td>
337
 
<td>    Lao
 
335
<td>Lao
338
336
</td>
339
337
</tr>
340
338
<tr>
341
339
<td><p><a name="PANGO-SCRIPT-LATIN:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LATIN</code></span></p></td>
342
 
<td>    Latin
 
340
<td>Latin
343
341
</td>
344
342
</tr>
345
343
<tr>
346
344
<td><p><a name="PANGO-SCRIPT-MALAYALAM:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_MALAYALAM</code></span></p></td>
347
 
<td>    Malayalam
 
345
<td>Malayalam
348
346
</td>
349
347
</tr>
350
348
<tr>
351
349
<td><p><a name="PANGO-SCRIPT-MONGOLIAN:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_MONGOLIAN</code></span></p></td>
352
 
<td>    Mongolian
 
350
<td>Mongolian
353
351
</td>
354
352
</tr>
355
353
<tr>
356
354
<td><p><a name="PANGO-SCRIPT-MYANMAR:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_MYANMAR</code></span></p></td>
357
 
<td>    Myanmar
 
355
<td>Myanmar
358
356
</td>
359
357
</tr>
360
358
<tr>
361
359
<td><p><a name="PANGO-SCRIPT-OGHAM:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_OGHAM</code></span></p></td>
362
 
<td>    Ogham
 
360
<td>Ogham
363
361
</td>
364
362
</tr>
365
363
<tr>
366
364
<td><p><a name="PANGO-SCRIPT-OLD-ITALIC:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_OLD_ITALIC</code></span></p></td>
367
 
<td>    Old Italic
 
365
<td>Old Italic
368
366
</td>
369
367
</tr>
370
368
<tr>
371
369
<td><p><a name="PANGO-SCRIPT-ORIYA:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_ORIYA</code></span></p></td>
372
 
<td>    Oriya
 
370
<td>Oriya
373
371
</td>
374
372
</tr>
375
373
<tr>
376
374
<td><p><a name="PANGO-SCRIPT-RUNIC:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_RUNIC</code></span></p></td>
377
 
<td>    Runic
 
375
<td>Runic
378
376
</td>
379
377
</tr>
380
378
<tr>
381
379
<td><p><a name="PANGO-SCRIPT-SINHALA:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SINHALA</code></span></p></td>
382
 
<td>    Sinhala
 
380
<td>Sinhala
383
381
</td>
384
382
</tr>
385
383
<tr>
386
384
<td><p><a name="PANGO-SCRIPT-SYRIAC:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SYRIAC</code></span></p></td>
387
 
<td>    Syriac
 
385
<td>Syriac
388
386
</td>
389
387
</tr>
390
388
<tr>
391
389
<td><p><a name="PANGO-SCRIPT-TAMIL:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TAMIL</code></span></p></td>
392
 
<td>    Tamil
 
390
<td>Tamil
393
391
</td>
394
392
</tr>
395
393
<tr>
396
394
<td><p><a name="PANGO-SCRIPT-TELUGU:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TELUGU</code></span></p></td>
397
 
<td>    Telugu
 
395
<td>Telugu
398
396
</td>
399
397
</tr>
400
398
<tr>
401
399
<td><p><a name="PANGO-SCRIPT-THAANA:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_THAANA</code></span></p></td>
402
 
<td>    Thaana
 
400
<td>Thaana
403
401
</td>
404
402
</tr>
405
403
<tr>
406
404
<td><p><a name="PANGO-SCRIPT-THAI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_THAI</code></span></p></td>
407
 
<td>    Thai
 
405
<td>Thai
408
406
</td>
409
407
</tr>
410
408
<tr>
411
409
<td><p><a name="PANGO-SCRIPT-TIBETAN:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TIBETAN</code></span></p></td>
412
 
<td>    Tibetan
 
410
<td>Tibetan
413
411
</td>
414
412
</tr>
415
413
<tr>
416
414
<td><p><a name="PANGO-SCRIPT-CANADIAN-ABORIGINAL:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CANADIAN_ABORIGINAL</code></span></p></td>
417
 
<td>    Canadian Aboriginal
 
415
<td>Canadian Aboriginal
418
416
</td>
419
417
</tr>
420
418
<tr>
421
419
<td><p><a name="PANGO-SCRIPT-YI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_YI</code></span></p></td>
422
 
<td>    Yi
 
420
<td>Yi
423
421
</td>
424
422
</tr>
425
423
<tr>
426
424
<td><p><a name="PANGO-SCRIPT-TAGALOG:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TAGALOG</code></span></p></td>
427
 
<td>    Tagalog
 
425
<td>Tagalog
428
426
</td>
429
427
</tr>
430
428
<tr>
431
429
<td><p><a name="PANGO-SCRIPT-HANUNOO:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_HANUNOO</code></span></p></td>
432
 
<td>    Hanunoo
 
430
<td>Hanunoo
433
431
</td>
434
432
</tr>
435
433
<tr>
436
434
<td><p><a name="PANGO-SCRIPT-BUHID:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BUHID</code></span></p></td>
437
 
<td>    Buhid
 
435
<td>Buhid
438
436
</td>
439
437
</tr>
440
438
<tr>
441
439
<td><p><a name="PANGO-SCRIPT-TAGBANWA:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TAGBANWA</code></span></p></td>
442
 
<td>    Tagbanwa
 
440
<td>Tagbanwa
443
441
</td>
444
442
</tr>
445
443
<tr>
446
444
<td><p><a name="PANGO-SCRIPT-BRAILLE:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BRAILLE</code></span></p></td>
447
 
<td>    Braille
 
445
<td>Braille
448
446
</td>
449
447
</tr>
450
448
<tr>
451
449
<td><p><a name="PANGO-SCRIPT-CYPRIOT:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CYPRIOT</code></span></p></td>
452
 
<td>    Cypriot
 
450
<td>Cypriot
453
451
</td>
454
452
</tr>
455
453
<tr>
456
454
<td><p><a name="PANGO-SCRIPT-LIMBU:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LIMBU</code></span></p></td>
457
 
<td>    Limbu
 
455
<td>Limbu
458
456
</td>
459
457
</tr>
460
458
<tr>
461
459
<td><p><a name="PANGO-SCRIPT-OSMANYA:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_OSMANYA</code></span></p></td>
462
 
<td>    Osmanya
 
460
<td>Osmanya
463
461
</td>
464
462
</tr>
465
463
<tr>
466
464
<td><p><a name="PANGO-SCRIPT-SHAVIAN:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SHAVIAN</code></span></p></td>
467
 
<td>    Shavian
 
465
<td>Shavian
468
466
</td>
469
467
</tr>
470
468
<tr>
471
469
<td><p><a name="PANGO-SCRIPT-LINEAR-B:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LINEAR_B</code></span></p></td>
472
 
<td>    Linear B
 
470
<td>Linear B
473
471
</td>
474
472
</tr>
475
473
<tr>
476
474
<td><p><a name="PANGO-SCRIPT-TAI-LE:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TAI_LE</code></span></p></td>
477
 
<td>    Tai Le
 
475
<td>Tai Le
478
476
</td>
479
477
</tr>
480
478
<tr>
481
479
<td><p><a name="PANGO-SCRIPT-UGARITIC:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_UGARITIC</code></span></p></td>
482
 
<td>    Ugaritic
 
480
<td>Ugaritic
483
481
</td>
484
482
</tr>
485
483
<tr>
486
484
<td><p><a name="PANGO-SCRIPT-NEW-TAI-LUE:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_NEW_TAI_LUE</code></span></p></td>
487
 
<td>    New Tai Lue. Since 1.10
 
485
<td>New Tai Lue. Since 1.10
488
486
</td>
489
487
</tr>
490
488
<tr>
491
489
<td><p><a name="PANGO-SCRIPT-BUGINESE:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BUGINESE</code></span></p></td>
492
 
<td>    Buginese. Since 1.10
 
490
<td>Buginese. Since 1.10
493
491
</td>
494
492
</tr>
495
493
<tr>
496
494
<td><p><a name="PANGO-SCRIPT-GLAGOLITIC:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_GLAGOLITIC</code></span></p></td>
497
 
<td>    Glagolitic. Since 1.10
 
495
<td>Glagolitic. Since 1.10
498
496
</td>
499
497
</tr>
500
498
<tr>
501
499
<td><p><a name="PANGO-SCRIPT-TIFINAGH:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TIFINAGH</code></span></p></td>
502
 
<td>    Tifinagh. Since 1.10
 
500
<td>Tifinagh. Since 1.10
503
501
</td>
504
502
</tr>
505
503
<tr>
506
504
<td><p><a name="PANGO-SCRIPT-SYLOTI-NAGRI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SYLOTI_NAGRI</code></span></p></td>
507
 
<td>    Syloti Nagri. Since 1.10
 
505
<td>Syloti Nagri. Since 1.10
508
506
</td>
509
507
</tr>
510
508
<tr>
511
509
<td><p><a name="PANGO-SCRIPT-OLD-PERSIAN:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_OLD_PERSIAN</code></span></p></td>
512
 
<td>    Old Persian. Since 1.10
 
510
<td>Old Persian. Since 1.10
513
511
</td>
514
512
</tr>
515
513
<tr>
516
514
<td><p><a name="PANGO-SCRIPT-KHAROSHTHI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_KHAROSHTHI</code></span></p></td>
517
 
<td>    Kharoshthi. Since 1.10
 
515
<td>Kharoshthi. Since 1.10
518
516
</td>
519
517
</tr>
520
518
<tr>
521
519
<td><p><a name="PANGO-SCRIPT-UNKNOWN:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_UNKNOWN</code></span></p></td>
522
 
<td>            an unassigned code point. Since 1.14
 
520
<td>an unassigned code point. Since 1.14
523
521
</td>
524
522
</tr>
525
523
<tr>
526
524
<td><p><a name="PANGO-SCRIPT-BALINESE:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BALINESE</code></span></p></td>
527
 
<td>            Balinese. Since 1.14
 
525
<td>Balinese. Since 1.14
528
526
</td>
529
527
</tr>
530
528
<tr>
531
529
<td><p><a name="PANGO-SCRIPT-CUNEIFORM:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CUNEIFORM</code></span></p></td>
532
 
<td>    Cuneiform. Since 1.14
 
530
<td>Cuneiform. Since 1.14
533
531
</td>
534
532
</tr>
535
533
<tr>
536
534
<td><p><a name="PANGO-SCRIPT-PHOENICIAN:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_PHOENICIAN</code></span></p></td>
537
 
<td>    Phoenician. Since 1.14
 
535
<td>Phoenician. Since 1.14
538
536
</td>
539
537
</tr>
540
538
<tr>
541
539
<td><p><a name="PANGO-SCRIPT-PHAGS-PA:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_PHAGS_PA</code></span></p></td>
542
 
<td>            Phags-pa. Since 1.14
 
540
<td>Phags-pa. Since 1.14
543
541
</td>
544
542
</tr>
545
543
<tr>
546
544
<td><p><a name="PANGO-SCRIPT-NKO:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_NKO</code></span></p></td>
547
 
<td>            N'Ko. Since 1.14
 
545
<td>N'Ko. Since 1.14
548
546
</td>
549
547
</tr>
550
548
<tr>
551
549
<td><p><a name="PANGO-SCRIPT-KAYAH-LI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_KAYAH_LI</code></span></p></td>
552
 
<td>  Kayah Li. Since 1.20.1
 
550
<td>Kayah Li. Since 1.20.1
553
551
</td>
554
552
</tr>
555
553
<tr>
556
554
<td><p><a name="PANGO-SCRIPT-LEPCHA:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LEPCHA</code></span></p></td>
557
 
<td>    Lepcha. Since 1.20.1
 
555
<td>Lepcha. Since 1.20.1
558
556
</td>
559
557
</tr>
560
558
<tr>
561
559
<td><p><a name="PANGO-SCRIPT-REJANG:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_REJANG</code></span></p></td>
562
 
<td>    Rejang. Since 1.20.1
 
560
<td>Rejang. Since 1.20.1
563
561
</td>
564
562
</tr>
565
563
<tr>
566
564
<td><p><a name="PANGO-SCRIPT-SUNDANESE:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SUNDANESE</code></span></p></td>
567
 
<td> Sundanese. Since 1.20.1
 
565
<td>Sundanese. Since 1.20.1
568
566
</td>
569
567
</tr>
570
568
<tr>
574
572
</tr>
575
573
<tr>
576
574
<td><p><a name="PANGO-SCRIPT-CHAM:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CHAM</code></span></p></td>
577
 
<td>      Cham. Since 1.20.1
 
575
<td>Cham. Since 1.20.1
578
576
</td>
579
577
</tr>
580
578
<tr>
581
579
<td><p><a name="PANGO-SCRIPT-OL-CHIKI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_OL_CHIKI</code></span></p></td>
582
 
<td>  Ol Chiki. Since 1.20.1
 
580
<td>Ol Chiki. Since 1.20.1
583
581
</td>
584
582
</tr>
585
583
<tr>
586
584
<td><p><a name="PANGO-SCRIPT-VAI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_VAI</code></span></p></td>
587
 
<td>       Vai. Since 1.20.1
 
585
<td>Vai. Since 1.20.1
588
586
</td>
589
587
</tr>
590
588
<tr>
591
589
<td><p><a name="PANGO-SCRIPT-CARIAN:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CARIAN</code></span></p></td>
592
 
<td>    Carian. Since 1.20.1
 
590
<td>Carian. Since 1.20.1
593
591
</td>
594
592
</tr>
595
593
<tr>
596
594
<td><p><a name="PANGO-SCRIPT-LYCIAN:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LYCIAN</code></span></p></td>
597
 
<td>    Lycian. Since 1.20.1
 
595
<td>Lycian. Since 1.20.1
598
596
</td>
599
597
</tr>
600
598
<tr>
601
599
<td><p><a name="PANGO-SCRIPT-LYDIAN:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LYDIAN</code></span></p></td>
602
 
<td>    Lydian. Since 1.20.1
 
600
<td>Lydian. Since 1.20.1
603
601
</td>
604
602
</tr>
605
603
<tr>
606
604
<td><p><a name="PANGO-SCRIPT-BATAK:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BATAK</code></span></p></td>
607
 
<td>     Batak. Since 1.32
 
605
<td>Batak. Since 1.32
608
606
</td>
609
607
</tr>
610
608
<tr>
611
609
<td><p><a name="PANGO-SCRIPT-BRAHMI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BRAHMI</code></span></p></td>
612
 
<td>    Brahmi. Since 1.32
 
610
<td>Brahmi. Since 1.32
613
611
</td>
614
612
</tr>
615
613
<tr>
616
614
<td><p><a name="PANGO-SCRIPT-MANDAIC:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_MANDAIC</code></span></p></td>
617
 
<td>   Mandaic. Since 1.32
 
615
<td>Mandaic. Since 1.32
618
616
</td>
619
617
</tr>
620
618
<tr>
621
619
<td><p><a name="PANGO-SCRIPT-CHAKMA:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CHAKMA</code></span></p></td>
622
 
<td>              Chakma. Since: 1.32
 
620
<td>Chakma. Since: 1.32
623
621
</td>
624
622
</tr>
625
623
<tr>
626
624
<td><p><a name="PANGO-SCRIPT-MEROITIC-CURSIVE:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_MEROITIC_CURSIVE</code></span></p></td>
627
 
<td>    Meroitic Cursive. Since: 1.32
 
625
<td>Meroitic Cursive. Since: 1.32
628
626
</td>
629
627
</tr>
630
628
<tr>
634
632
</tr>
635
633
<tr>
636
634
<td><p><a name="PANGO-SCRIPT-MIAO:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_MIAO</code></span></p></td>
637
 
<td>                Miao. Since: 1.32
 
635
<td>Miao. Since: 1.32
638
636
</td>
639
637
</tr>
640
638
<tr>
641
639
<td><p><a name="PANGO-SCRIPT-SHARADA:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SHARADA</code></span></p></td>
642
 
<td>             Sharada. Since: 1.32
 
640
<td>Sharada. Since: 1.32
643
641
</td>
644
642
</tr>
645
643
<tr>
646
644
<td><p><a name="PANGO-SCRIPT-SORA-SOMPENG:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SORA_SOMPENG</code></span></p></td>
647
 
<td>        Sora Sompeng. Since: 1.32
 
645
<td>Sora Sompeng. Since: 1.32
648
646
</td>
649
647
</tr>
650
648
<tr>
651
649
<td><p><a name="PANGO-SCRIPT-TAKRI:CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TAKRI</code></span></p></td>
652
 
<td>               Takri. Since: 1.32
 
650
<td>Takri. Since: 1.32
653
651
</td>
654
652
</tr>
655
653
</tbody>
660
658
<a name="PANGO-TYPE-SCRIPT:CAPS"></a><h3>PANGO_TYPE_SCRIPT</h3>
661
659
<pre class="programlisting">#define PANGO_TYPE_SCRIPT (pango_script_get_type ())
662
660
</pre>
663
 
<p>
664
 
The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a>
665
 
</p>
666
661
</div>
667
662
<hr>
668
663
<div class="refsect2">
670
665
<pre class="programlisting">typedef struct _PangoScriptIter PangoScriptIter;</pre>
671
666
<p>
672
667
A <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a> is used to iterate through a string
673
 
and identify ranges in different scripts.
674
 
</p>
 
668
and identify ranges in different scripts.</p>
675
669
</div>
676
670
<hr>
677
671
<div class="refsect2">
679
673
<pre class="programlisting"><a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="returnvalue">PangoScript</span></a>         pango_script_for_unichar            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"><span class="type">gunichar</span></a> ch</code></em>);</pre>
680
674
<p>
681
675
Looks up the <a class="link" href="pango-Scripts-and-Languages.html#PangoScript"><span class="type">PangoScript</span></a> for a particular character (as defined by
682
 
Unicode Standard Annex <span class="type">24</span>). No check is made for <em class="parameter"><code>ch</code></em> being a
 
676
Unicode Standard Annex #24). No check is made for <em class="parameter"><code>ch</code></em> being a
683
677
valid Unicode character; if you pass in invalid character, the
684
 
result is undefined.
685
 
</p>
 
678
result is undefined.</p>
686
679
<p>
687
680
As of Pango 1.18, this function simply returns the return value of
688
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#g-unichar-get-script"><code class="function">g_unichar_get_script()</code></a>.
689
 
</p>
 
681
<a href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#g-unichar-get-script"><code class="function">g_unichar_get_script()</code></a>.</p>
690
682
<div class="variablelist"><table border="0" class="variablelist">
691
683
<colgroup>
692
684
<col align="left" valign="top">
715
707
most widely spoken or used language written in that script:
716
708
for instance, the sample language for <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-CYRILLIC:CAPS"><code class="literal">PANGO_SCRIPT_CYRILLIC</code></a>
717
709
is <code class="literal">ru</code> (Russian), the sample language
718
 
for <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-ARABIC:CAPS"><code class="literal">PANGO_SCRIPT_ARABIC</code></a> is <code class="literal">ar</code>.
719
 
</p>
 
710
for <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-ARABIC:CAPS"><code class="literal">PANGO_SCRIPT_ARABIC</code></a> is <code class="literal">ar</code>.</p>
720
711
<p>
721
712
For some
722
713
scripts, no sample language will be returned because there
725
716
variants of written Chinese, Japanese, and Korean all use
726
717
significantly different sets of Han characters and forms
727
718
of shared characters. No sample language can be provided
728
 
for many historical scripts as well.
729
 
</p>
 
719
for many historical scripts as well.</p>
730
720
<p>
731
721
As of 1.18, this function checks the environment variables
732
722
PANGO_LANGUAGE and LANGUAGE (checked in that order) first.
741
731
instead of Arabic (ar) when a segment of Arabic text is found
742
732
in an otherwise non-Arabic text.  The same trick can be used to
743
733
choose a default language for <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-HAN:CAPS"><code class="literal">PANGO_SCRIPT_HAN</code></a> when setting
744
 
context language is not feasible.
745
 
</p>
 
734
context language is not feasible.</p>
746
735
<div class="variablelist"><table border="0" class="variablelist">
747
736
<colgroup>
748
737
<col align="left" valign="top">
772
761
Create a new <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a>, used to break a string of
773
762
Unicode into runs by text. No copy is made of <em class="parameter"><code>text</code></em>, so
774
763
the caller needs to make sure it remains valid until
775
 
the iterator is freed with <a class="link" href="pango-Scripts-and-Languages.html#pango-script-iter-free" title="pango_script_iter_free ()"><code class="function">pango_script_iter_free()</code></a>.
776
 
</p>
 
764
the iterator is freed with <a class="link" href="pango-Scripts-and-Languages.html#pango-script-iter-free" title="pango_script_iter_free ()"><code class="function">pango_script_iter_free()</code></a>.</p>
777
765
<div class="variablelist"><table border="0" class="variablelist">
778
766
<colgroup>
779
767
<col align="left" valign="top">
809
797
<p>
810
798
Gets information about the range to which <em class="parameter"><code>iter</code></em> currently points.
811
799
The range is the set of locations p where *start &lt;= p &lt; *end.
812
 
(That is, it doesn't include the character stored at *end)
813
 
</p>
 
800
(That is, it doesn't include the character stored at *end)</p>
814
801
<div class="variablelist"><table border="0" class="variablelist">
815
802
<colgroup>
816
803
<col align="left" valign="top">
848
835
<p>
849
836
Advances a <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a> to the next range. If <em class="parameter"><code>iter</code></em>
850
837
is already at the end, it is left unchanged and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
851
 
is returned.
852
 
</p>
 
838
is returned.</p>
853
839
<div class="variablelist"><table border="0" class="variablelist">
854
840
<colgroup>
855
841
<col align="left" valign="top">
875
861
<a name="pango-script-iter-free"></a><h3>pango_script_iter_free ()</h3>
876
862
<pre class="programlisting"><span class="returnvalue">void</span>                pango_script_iter_free              (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a> *iter</code></em>);</pre>
877
863
<p>
878
 
Frees a <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a> created with <a class="link" href="pango-Scripts-and-Languages.html#pango-script-iter-new" title="pango_script_iter_new ()"><code class="function">pango_script_iter_new()</code></a>.
879
 
</p>
 
864
Frees a <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a> created with <a class="link" href="pango-Scripts-and-Languages.html#pango-script-iter-new" title="pango_script_iter_new ()"><code class="function">pango_script_iter_new()</code></a>.</p>
880
865
<div class="variablelist"><table border="0" class="variablelist">
881
866
<colgroup>
882
867
<col align="left" valign="top">
896
881
<pre class="programlisting">typedef struct _PangoLanguage PangoLanguage;</pre>
897
882
<p>
898
883
The <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> structure is used to
899
 
represent a language.
900
 
</p>
 
884
represent a language.</p>
901
885
<p>
902
886
<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> pointers can be efficiently
903
 
copied and compared with each other.
904
 
</p>
 
887
copied and compared with each other.</p>
905
888
</div>
906
889
<hr>
907
890
<div class="refsect2">
909
892
<pre class="programlisting">#define PANGO_TYPE_LANGUAGE (pango_language_get_type ())
910
893
</pre>
911
894
<p>
912
 
The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a>.
913
 
</p>
 
895
The <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a>.</p>
914
896
</div>
915
897
<hr>
916
898
<div class="refsect2">
920
902
Take a RFC-3066 format language tag as a string and convert it to a
921
903
<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> pointer that can be efficiently copied (copy the
922
904
pointer) and compared with other language tags (compare the
923
 
pointer.)
924
 
</p>
 
905
pointer.)</p>
925
906
<p>
926
907
This function first canonicalizes the string by converting it to
927
908
lowercase, mapping '_' to '-', and stripping all characters other
928
 
than letters and '-'.
929
 
</p>
 
909
than letters and '-'.</p>
930
910
<p>
931
911
Use <a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-default" title="pango_language_get_default ()"><code class="function">pango_language_get_default()</code></a> if you want to get the <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> for
932
 
the current locale of the process.
933
 
</p>
 
912
the current locale of the process.</p>
934
913
<div class="variablelist"><table border="0" class="variablelist">
935
914
<colgroup>
936
915
<col align="left" valign="top">
958
937
<a name="pango-language-to-string"></a><h3>pango_language_to_string ()</h3>
959
938
<pre class="programlisting">const <span class="returnvalue">char</span> *        pango_language_to_string            (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>
960
939
<p>
961
 
Gets the RFC-3066 format string representing the given language tag.
962
 
</p>
 
940
Gets the RFC-3066 format string representing the given language tag.</p>
963
941
<div class="variablelist"><table border="0" class="variablelist">
964
942
<colgroup>
965
943
<col align="left" valign="top">
988
966
language ranges. A language tag is considered to match a range
989
967
in the list if the range is '*', the range is exactly the tag,
990
968
or the range is a prefix of the tag, and the character after it
991
 
in the tag is '-'.
992
 
</p>
 
969
in the tag is '-'.</p>
993
970
<div class="variablelist"><table border="0" class="variablelist">
994
971
<colgroup>
995
972
<col align="left" valign="top">
1027
1004
write <em class="parameter"><code>language</code></em>. The returned value is conservative;
1028
1005
if nothing is known about the language tag <em class="parameter"><code>language</code></em>,
1029
1006
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> will be returned, since, as far as Pango knows,
1030
 
<em class="parameter"><code>script</code></em> might be used to write <em class="parameter"><code>language</code></em>.
1031
 
</p>
 
1007
<em class="parameter"><code>script</code></em> might be used to write <em class="parameter"><code>language</code></em>.</p>
1032
1008
<p>
1033
1009
This routine is used in Pango's itemization process when
1034
1010
determining if a supplied language tag is relevant to
1035
1011
a particular section of text. It probably is not useful for
1036
 
applications in most circumstances.
1037
 
</p>
 
1012
applications in most circumstances.</p>
1038
1013
<p>
1039
 
This function uses <a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-scripts" title="pango_language_get_scripts ()"><code class="function">pango_language_get_scripts()</code></a> internally.
1040
 
</p>
 
1014
This function uses <a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-scripts" title="pango_language_get_scripts ()"><code class="function">pango_language_get_scripts()</code></a> internally.</p>
1041
1015
<div class="variablelist"><table border="0" class="variablelist">
1042
1016
<colgroup>
1043
1017
<col align="left" valign="top">
1076
1050
If nothing is known about the language tag <em class="parameter"><code>language</code></em>,
1077
1051
or if <em class="parameter"><code>language</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned.
1078
1052
The list of scripts returned starts with the script that the
1079
 
language uses most and continues to the one it uses least.
1080
 
</p>
 
1053
language uses most and continues to the one it uses least.</p>
1081
1054
<p>
1082
1055
The value <em class="parameter"><code>num_script</code></em> points at will be set to the number
1083
 
of scripts in the returned array (or zero if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned).
1084
 
</p>
 
1056
of scripts in the returned array (or zero if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned).</p>
1085
1057
<p>
1086
1058
Most languages use only one script for writing, but there are
1087
1059
some that use two (Latin and Cyrillic for example), and a few
1088
1060
use three (Japanese for example).  Applications should not make
1089
1061
any assumptions on the maximum number of scripts returned
1090
1062
though, except that it is positive if the return value is not
1091
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, and it is a small number.
1092
 
</p>
 
1063
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, and it is a small number.</p>
1093
1064
<p>
1094
1065
The <a class="link" href="pango-Scripts-and-Languages.html#pango-language-includes-script" title="pango_language_includes_script ()"><code class="function">pango_language_includes_script()</code></a> function uses this function
1095
 
internally.
1096
 
</p>
 
1066
internally.</p>
1097
1067
<div class="variablelist"><table border="0" class="variablelist">
1098
1068
<colgroup>
1099
1069
<col align="left" valign="top">
1131
1101
<pre class="programlisting"><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="returnvalue">PangoLanguage</span></a> *     pango_language_get_default          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1132
1102
<p>
1133
1103
Returns the <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> for the current locale of the process.
1134
 
Note that this can change over the life of an application.
1135
 
</p>
 
1104
Note that this can change over the life of an application.</p>
1136
1105
<p>
1137
1106
On Unix systems, this is the return value is derived from
1138
1107
<code class="literal">setlocale(LC_CTYPE, NULL)</code>, and the user can
1141
1110
the form lang_COUNTRY, where lang is an ISO-639 language code, and
1142
1111
COUNTRY is an ISO-3166 country code. For instance, sv_FI for
1143
1112
Swedish as written in Finland or pt_BR for Portuguese as written in
1144
 
Brazil.
1145
 
</p>
 
1113
Brazil.</p>
1146
1114
<p>
1147
1115
On Windows, the C library does not use any such environment
1148
1116
variables, and setting them won't affect the behavior of functions
1152
1120
names spelled out in English.
1153
1121
However, this function does check the above environment
1154
1122
variables, and does return a Unix-style locale string based on
1155
 
either said environment variables or the thread's current locale.
1156
 
</p>
 
1123
either said environment variables or the thread's current locale.</p>
1157
1124
<p>
1158
1125
Your application should call <code class="literal">setlocale(LC_ALL, "");</code>
1159
1126
for the user settings to take effect.  Gtk+ does this in its initialization
1160
1127
functions automatically (by calling <a href="http://library.gnome.org/devel/gtk3/gtk2-General.html#gtk-set-locale"><code class="function">gtk_set_locale()</code></a>).
1161
 
See <code class="literal">man setlocale</code> for more details.
1162
 
</p>
 
1128
See <code class="literal">man setlocale</code> for more details.</p>
1163
1129
<div class="variablelist"><table border="0" class="variablelist">
1164
1130
<colgroup>
1165
1131
<col align="left" valign="top">
1180
1146
<pre class="programlisting">const <span class="returnvalue">char</span> *        pango_language_get_sample_string    (<em class="parameter"><code><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> *language</code></em>);</pre>
1181
1147
<p>
1182
1148
Get a string that is representative of the characters needed to
1183
 
render a particular language.
1184
 
</p>
 
1149
render a particular language.</p>
1185
1150
<p>
1186
1151
The sample text may be a pangram, but is not necessarily.  It is chosen to
1187
1152
be demonstrative of normal text in the language, as well as exposing font
1188
1153
feature requirements unique to the language.  It is suitable for use
1189
 
as sample text in a font selection dialog.
1190
 
</p>
 
1154
as sample text in a font selection dialog.</p>
1191
1155
<p>
1192
1156
If <em class="parameter"><code>language</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the default language as found by
1193
 
<a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-default" title="pango_language_get_default ()"><code class="function">pango_language_get_default()</code></a> is used.
1194
 
</p>
 
1157
<a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-default" title="pango_language_get_default ()"><code class="function">pango_language_get_default()</code></a> is used.</p>
1195
1158
<p>
1196
1159
If Pango does not have a sample string for <em class="parameter"><code>language</code></em>, the classic
1197
1160
"The quick brown fox..." is returned.  This can be detected by
1209
1172
  </table>
1210
1173
</div>
1211
1174
 
1212
 
<p>
1213
 
</p>
1214
1175
<div class="variablelist"><table border="0" class="variablelist">
1215
1176
<colgroup>
1216
1177
<col align="left" valign="top">