[HarfBuzz] where is the documentation

[Ebrahim Byagowi]

I think I've mislead you, I didn't mean to use the documentation of that
library :) I think old harfbuzz had some of the things you've mentioned
like justification.

Anyways, I guess this link
<https://mail.gnome.org/archives/gtk-i18n-list/2009-August/msg00025.html>
would be more useful as some of basic (probably you know them already) but
expected to be used more APIs are described there at least.

Another perhaps interesting way to measure usage of an API and understand
its use is to inspect other clients, specially the big ones like
Chromium/Google Chrome which should handles many edge cases. For example,
"hb_font_get_glyph_advance_for_direction" is not used once even on
Chromium once
even
<https://cs.chromium.org/search/?q=hb_font_get_glyph_advance_for_direction&sq=package:chromium&type=cs>
which roughly means it is not of a canonical API for the library and
hb_font_get_glyph is used here
<https://cs.chromium.org/chromium/src/third_party/WebKit/Source/platform/fonts/FontPlatformData.cpp?q=hb_font_get_glyph&sq=package:chromium&dr=C&l=282>
which
checks if a font has a special glyph for space so is it possible to use
caching word shaping strategy (in here, if a font contains space glyph it
means the strategy should be turned off but for the majority of fonts it is
not the case), very special strategy not used by every client of harfbuzz
and the API also doesn't seem to be essential for most of clients.

On Mon, Jun 27, 2016 at 4:36 AM, Kelvin Ma <kelvinsthirteen at gmail.com>
wrote:

> Well this is the first time I’ve used a shaper, and also the first time
> i’ve been told to learn how to use a library by using a different library’s
> documentation. At any rate I thought harfbuzz doesn’t do
> itemization/justification/reversal, so it doesn’t seem that library even
> does the same thing as harfbuzz.
>
> On Sun, Jun 26, 2016 at 5:03 PM, Ebrahim Byagowi <ebraminio at gmail.com>
> wrote:
>
>> This weren't shocking for you that much if you had a chance to use
>> proprietary shapers, at least according to initial paragraphs of
>> https://maxradi.us/documents/uniscribe/ and uniscribe backend
>> <https://github.com/behdad/harfbuzz/blob/master/src/hb-uniscribe.cc#L606>
>> of harfbuzz ;)
>>
>> On Sun, Jun 26, 2016 at 9:23 PM, Kelvin Ma <kelvinsthirteen at gmail.com>
>> wrote:
>>
>>> can someone please explain what each of the functions & their arguments
>>> at https://lazka.github.io/pgi-docs/HarfBuzz-0.0/functions.html
>>> actually do?
>>>
>>> Particularly font_get_glyph() and
>>> font_get_glyph_advance_for_direction().
>>>
>>> no shade but how does anyone actually manage to use this library in
>>> their projects if barely 5% of it is documented at all
>>>
>>> _______________________________________________
>>> HarfBuzz mailing list
>>> HarfBuzz at lists.freedesktop.org
>>> https://lists.freedesktop.org/mailman/listinfo/harfbuzz
>>>
>>>
>>
>>
>
> _______________________________________________
> HarfBuzz mailing list
> HarfBuzz at lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/harfbuzz
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.freedesktop.org/archives/harfbuzz/attachments/20160627/10211500/attachment.html>