@gtkx/ffi 0.10.5 → 0.11.0

package/dist/generated/pango/functions.d.ts

@@ -1,8 +1,9 @@
 import { Ref } from "@gtkx/native";
 import { AttrType, BidiType, Direction, FontScale, Gravity, GravityHint, Overline, Script, ShapeFlags, ShowFlags, Stretch, Style, TextTransform, Underline, Variant, Weight } from "./enums.js";
+import { Analysis } from "./analysis.js";
+import { Attribute } from "./attribute.js";
 import { AttrIterator } from "./attr-iterator.js";
 import { AttrList } from "./attr-list.js";
-import { Attribute } from "./attribute.js";
 import { FontDescription } from "./font-description.js";
 import { GlyphString } from "./glyph-string.js";
 import { Item } from "./item.js";
@@ -18,20 +19,11 @@ import * as GLib from "../glib/index.js";
  *
  * If breaks are disabled, the range will be kept in a
  * single run, as far as possible.
- * @param allowBreaks - %TRUE if we line breaks are allowed
  */
 export declare const attrAllowBreaksNew: (allowBreaks: boolean) => Attribute;
-/**
- * Create a new background alpha attribute.
- * @param alpha - the alpha value, between 1 and 65536
- */
+/** Create a new background alpha attribute. */
 export declare const attrBackgroundAlphaNew: (alpha: number) => Attribute;
-/**
- * Create a new background color attribute.
- * @param red - the red value (ranging from 0 to 65535)
- * @param green - the green value
- * @param blue - the blue value
- */
+/** Create a new background color attribute. */
 export declare const attrBackgroundNew: (red: number, green: number, blue: number) => Attribute;
 /**
  * Create a new baseline displacement attribute.
@@ -40,7 +32,6 @@ export declare const attrBackgroundNew: (red: number, green: number, blue: numbe
  * relative to the run of preceding run.
  *
  * ![Baseline Shift](https://docs.gtk.org/Pango/baseline-shift-light.png)
- * @param shift - either a `PangoBaselineShift` enumeration value or an absolute value (> 1024)
  */
 export declare const attrBaselineShiftNew: (shift: number) => Attribute;
 /**
@@ -48,12 +39,6 @@ export declare const attrBaselineShiftNew: (shift: number) => Attribute;
  *
  * The line breaks are assumed to have been produced
  * by {@link Pango.default_break} and {@link Pango.tailor_break}.
- * @param text - text to break. Must be valid UTF-8
- * @param length - length of text in bytes (may be -1 if `text` is nul-terminated)
- * @param attrList - `PangoAttrList` to apply
- * @param offset - Byte offset of `text` from the beginning of the paragraph
- * @param attrs - array with one
- * @param attrsLen - length of `attrs` array
  */
 export declare const attrBreak: (text: string, length: number, attrList: AttrList, offset: number, attrs: Ref<LogAttr[]>, attrsLen: number) => void;
 /**
@@ -63,20 +48,15 @@ export declare const attrBreak: (text: string, length: number, attrList: AttrLis
  * used from the closest matching font on the system.
  * No fallback will be done to other fonts on the system
  * that might contain the characters in the text.
- * @param enableFallback - %TRUE if we should fall back on other fonts
  */
 export declare const attrFallbackNew: (enableFallback: boolean) => Attribute;
-/**
- * Create a new font family attribute.
- * @param family - the family or comma-separated list of families
- */
+/** Create a new font family attribute. */
 export declare const attrFamilyNew: (family: string) => Attribute;
 /**
  * Create a new font description attribute.
  *
  * This attribute allows setting family, style, weight, variant,
  * stretch, and size simultaneously.
- * @param desc - the font description
  */
 export declare const attrFontDescNew: (desc: FontDescription) => Attribute;
 /**
@@ -84,7 +64,6 @@ export declare const attrFontDescNew: (desc: FontDescription) => Attribute;
  *
  * You can use this attribute to select OpenType font features like small-caps,
  * alternative glyphs, ligatures, etc. for fonts that support them.
- * @param features - a string with OpenType font features, with the syntax of the [CSS
  */
 export declare const attrFontFeaturesNew: (features: string) => Attribute;
 /**
@@ -92,30 +71,15 @@ export declare const attrFontFeaturesNew: (features: string) => Attribute;
  *
  * The effect of this attribute is to change the font size of a run,
  * relative to the size of preceding run.
- * @param scale - a `PangoFontScale` value, which indicates font size change relative
  */
 export declare const attrFontScaleNew: (scale: FontScale) => Attribute;
-/**
- * Create a new foreground alpha attribute.
- * @param alpha - the alpha value, between 1 and 65536
- */
+/** Create a new foreground alpha attribute. */
 export declare const attrForegroundAlphaNew: (alpha: number) => Attribute;
-/**
- * Create a new foreground color attribute.
- * @param red - the red value (ranging from 0 to 65535)
- * @param green - the green value
- * @param blue - the blue value
- */
+/** Create a new foreground color attribute. */
 export declare const attrForegroundNew: (red: number, green: number, blue: number) => Attribute;
-/**
- * Create a new gravity hint attribute.
- * @param hint - the gravity hint value
- */
+/** Create a new gravity hint attribute. */
 export declare const attrGravityHintNew: (hint: GravityHint) => Attribute;
-/**
- * Create a new gravity attribute.
- * @param gravity - the gravity value; should not be %PANGO_GRAVITY_AUTO
- */
+/** Create a new gravity attribute. */
 export declare const attrGravityNew: (gravity: Gravity) => Attribute;
 /**
  * Create a new insert-hyphens attribute.
@@ -123,18 +87,11 @@ export declare const attrGravityNew: (gravity: Gravity) => Attribute;
  * Pango will insert hyphens when breaking lines in
  * the middle of a word. This attribute can be used
  * to suppress the hyphen.
- * @param insertHyphens - %TRUE if hyphens should be inserted
  */
 export declare const attrInsertHyphensNew: (insertHyphens: boolean) => Attribute;
-/**
- * Create a new language tag attribute.
- * @param language - language tag
- */
+/** Create a new language tag attribute. */
 export declare const attrLanguageNew: (language: Language) => Attribute;
-/**
- * Create a new letter-spacing attribute.
- * @param letterSpacing - amount of extra space to add between
- */
+/** Create a new letter-spacing attribute. */
 export declare const attrLetterSpacingNew: (letterSpacing: number) => Attribute;
 /**
  * Modify the height of logical line extents by a factor.
@@ -143,7 +100,6 @@ export declare const attrLetterSpacingNew: (letterSpacing: number) => Attribute;
  * {@link Pango.LayoutLine.get_extents},
  * {@link Pango.LayoutLine.get_pixel_extents} and
  * {@link Pango.LayoutIter.get_line_extents}.
- * @param factor - the scaling factor to apply to the logical height
  */
 export declare const attrLineHeightNew: (factor: number) => Attribute;
 /**
@@ -153,7 +109,6 @@ export declare const attrLineHeightNew: (factor: number) => Attribute;
  * {@link Pango.LayoutLine.get_extents},
  * {@link Pango.LayoutLine.get_pixel_extents} and
  * {@link Pango.LayoutIter.get_line_extents}.
- * @param height - the line height, in %PANGO_SCALE-ths of a point
  */
 export declare const attrLineHeightNewAbsolute: (height: number) => Attribute;
 /**
@@ -161,7 +116,6 @@ export declare const attrLineHeightNewAbsolute: (height: number) => Attribute;
  *
  * This is the counterpart to {@link Pango.AttrList.to_string}.
  * See that functions for details about the format.
- * @param text - a string
  */
 export declare const attrListFromString: (text: string) => AttrList | null;
 /**
@@ -169,27 +123,17 @@ export declare const attrListFromString: (text: string) => AttrList | null;
  *
  * This attribute modifies the color of overlines.
  * If not set, overlines will use the foreground color.
- * @param red - the red value (ranging from 0 to 65535)
- * @param green - the green value
- * @param blue - the blue value
  */
 export declare const attrOverlineColorNew: (red: number, green: number, blue: number) => Attribute;
-/**
- * Create a new overline-style attribute.
- * @param overline - the overline style
- */
+/** Create a new overline-style attribute. */
 export declare const attrOverlineNew: (overline: Overline) => Attribute;
-/**
- * Create a new baseline displacement attribute.
- * @param rise - the amount that the text should be displaced vertically,
- */
+/** Create a new baseline displacement attribute. */
 export declare const attrRiseNew: (rise: number) => Attribute;
 /**
  * Create a new font size scale attribute.
  *
  * The base font for the affected text will have
  * its size multiplied by `scale_factor`.
- * @param scaleFactor - factor to scale the font
  */
 export declare const attrScaleNew: (scaleFactor: number) => Attribute;
 /**
@@ -206,55 +150,33 @@ export declare const attrSentenceNew: () => Attribute;
  * rectangle on the result of shaping a particular glyph.
  * This might be used, for instance, for embedding a picture
  * or a widget inside a `PangoLayout`.
- * @param inkRect - ink rectangle to assign to each character
- * @param logicalRect - logical rectangle to assign to each character
  */
 export declare const attrShapeNew: (inkRect: Rectangle, logicalRect: Rectangle) => Attribute;
 /**
  * Create a new attribute that influences how invisible
  * characters are rendered.
- * @param flags - `PangoShowFlags` to apply
  */
 export declare const attrShowNew: (flags: ShowFlags) => Attribute;
-/**
- * Create a new font-size attribute in fractional points.
- * @param size - the font size, in %PANGO_SCALE-ths of a point
- */
+/** Create a new font-size attribute in fractional points. */
 export declare const attrSizeNew: (size: number) => Attribute;
-/**
- * Create a new font-size attribute in device units.
- * @param size - the font size, in %PANGO_SCALE-ths of a device unit
- */
+/** Create a new font-size attribute in device units. */
 export declare const attrSizeNewAbsolute: (size: number) => Attribute;
-/**
- * Create a new font stretch attribute.
- * @param stretch - the stretch
- */
+/** Create a new font stretch attribute. */
 export declare const attrStretchNew: (stretch: Stretch) => Attribute;
 /**
  * Create a new strikethrough color attribute.
  *
  * This attribute modifies the color of strikethrough lines.
  * If not set, strikethrough lines will use the foreground color.
- * @param red - the red value (ranging from 0 to 65535)
- * @param green - the green value
- * @param blue - the blue value
  */
 export declare const attrStrikethroughColorNew: (red: number, green: number, blue: number) => Attribute;
-/**
- * Create a new strike-through attribute.
- * @param strikethrough - %TRUE if the text should be struck-through
- */
+/** Create a new strike-through attribute. */
 export declare const attrStrikethroughNew: (strikethrough: boolean) => Attribute;
-/**
- * Create a new font slant style attribute.
- * @param style - the slant style
- */
+/** Create a new font slant style attribute. */
 export declare const attrStyleNew: (style: Style) => Attribute;
 /**
  * Create a new attribute that influences how characters
  * are transformed during shaping.
- * @param transform - `PangoTextTransform` to apply
  */
 export declare const attrTextTransformNew: (transform: TextTransform) => Attribute;
 /**
@@ -267,7 +189,6 @@ export declare const attrTextTransformNew: (transform: TextTransform) => Attribu
  * The returned value is an interned string (see
  * g_intern_string() for what that means) that should
  * not be modified or freed.
- * @param type - an attribute type ID to fetch the name for
  */
 export declare const attrTypeGetName: (type: AttrType) => string | null;
 /**
@@ -275,7 +196,6 @@ export declare const attrTypeGetName: (type: AttrType) => string | null;
  *
  * The attribute type name can be accessed later
  * by using {@link Pango.AttrType.get_name}.
- * @param name - an identifier for the type
  */
 export declare const attrTypeRegister: (name: string) => AttrType;
 /**
@@ -283,25 +203,13 @@ export declare const attrTypeRegister: (name: string) => AttrType;
  *
  * This attribute modifies the color of underlines.
  * If not set, underlines will use the foreground color.
- * @param red - the red value (ranging from 0 to 65535)
- * @param green - the green value
- * @param blue - the blue value
  */
 export declare const attrUnderlineColorNew: (red: number, green: number, blue: number) => Attribute;
-/**
- * Create a new underline-style attribute.
- * @param underline - the underline style
- */
+/** Create a new underline-style attribute. */
 export declare const attrUnderlineNew: (underline: Underline) => Attribute;
-/**
- * Create a new font variant attribute (normal or small caps).
- * @param variant - the variant
- */
+/** Create a new font variant attribute (normal or small caps). */
 export declare const attrVariantNew: (variant: Variant) => Attribute;
-/**
- * Create a new font weight attribute.
- * @param weight - the weight
- */
+/** Create a new font weight attribute. */
 export declare const attrWeightNew: (weight: Weight) => Attribute;
 /**
  * Marks the range of the attribute as a single word.
@@ -316,7 +224,6 @@ export declare const attrWordNew: () => Attribute;
  * The bidirectional type is specified in the Unicode Character Database.
  *
  * A simplified version of this function is available as {@link unichar_direction}.
- * @param ch - a Unicode character
  */
 export declare const bidiTypeForUnichar: (ch: number) => BidiType;
 /**
@@ -324,13 +231,8 @@ export declare const bidiTypeForUnichar: (ch: number) => BidiType;
  * for a string of Unicode text with a single analysis.
  *
  * For most purposes you may want to use {@link Pango.get_log_attrs}.
- * @param text - the text to process. Must be valid UTF-8
- * @param length - length of `text` in bytes (may be -1 if `text` is nul-terminated)
- * @param analysis - `PangoAnalysis` structure for `text`
- * @param attrs - an array to
- * @param attrsLen - size of the array passed as `attrs`
  */
-export declare const _break: (text: string, length: number, analysis: number, attrs: Ref<LogAttr[]>, attrsLen: number) => void;
+export declare const break_: (text: string, length: number, analysis: Analysis, attrs: Ref<LogAttr[]>, attrsLen: number) => void;
 /**
  * This is the default break algorithm.
  *
@@ -341,13 +243,8 @@ export declare const _break: (text: string, length: number, analysis: number, at
  * See {@link Pango.tailor_break} for language-specific breaks.
  *
  * See {@link Pango.attr_break} for attribute-based customization.
- * @param text - text to break. Must be valid UTF-8
- * @param length - length of text in bytes (may be -1 if `text` is nul-terminated)
- * @param analysis - a `PangoAnalysis` structure for the `text`
- * @param attrs - logical
- * @param attrsLen - size of the array passed as `attrs`
  */
-export declare const defaultBreak: (text: string, length: number, attrs: Ref<LogAttr[]>, attrsLen: number, analysis?: number) => void;
+export declare const defaultBreak: (text: string, length: number, attrs: Ref<LogAttr[]>, attrsLen: number, analysis?: Analysis | null) => void;
 /**
  * Converts extents from Pango units to device units.
  *
@@ -366,15 +263,11 @@ export declare const defaultBreak: (text: string, length: number, attrs: Ref<Log
  * `inclusive`. If you want two touching-but-not-overlapping rectangles stay
  * touching-but-not-overlapping after rounding to device units, pass them in
  * as `nearest`.
- * @param inclusive - rectangle to round to pixels inclusively
- * @param nearest - rectangle to round to nearest pixels
  */
 export declare const extentsToPixels: (inclusive: Ref<Rectangle>, nearest: Ref<Rectangle>) => void;
 /**
  * Searches a string the first character that has a strong
  * direction, according to the Unicode bidirectional algorithm.
- * @param text - the text to process. Must be valid UTF-8
- * @param length - length of `text` in bytes (may be -1 if `text` is nul-terminated)
  */
 export declare const findBaseDir: (text: string, length: number) => Direction;
 /**
@@ -392,18 +285,14 @@ export declare const findBaseDir: (text: string, length: number) => Direction;
  * If no delimiters are found, both `paragraph_delimiter_index`
  * and `next_paragraph_start` are filled with the length of `text`
  * (an index one off the end).
- * @param text - UTF-8 text
- * @param length - length of `text` in bytes, or -1 if nul-terminated
- * @param paragraphDelimiterIndex - return location
- * @param nextParagraphStart - return location for
  */
-export declare const findParagraphBoundary: (text: string, length: number, paragraphDelimiterIndex?: Ref<number>, nextParagraphStart?: Ref<number>) => void;
+export declare const findParagraphBoundary: (text: string, length: number, paragraphDelimiterIndex?: Ref<number> | null, nextParagraphStart?: Ref<number> | null) => void;
 /**
  * Creates a new font description from a string representation.
  *
  * The string must have the form
  *
- * [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] [VARIATIONS] [FEATURES]
+ *     [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] [VARIATIONS] [FEATURES]
  *
  * where FAMILY-LIST is a comma-separated list of families optionally
  * terminated by a comma, STYLE_OPTIONS is a whitespace-separated list
@@ -450,8 +339,7 @@ export declare const findParagraphBoundary: (text: string, length: number, parag
  *
  * A typical example:
  *
- * Cantarell Italic Light 15 @‍wght=200 #‍tnum=1
- * @param str - string representation of a font description.
+ *     Cantarell Italic Light 15 @‍wght=200 #‍tnum=1
  */
 export declare const fontDescriptionFromString: (str: string) => FontDescription;
 /**
@@ -464,28 +352,19 @@ export declare const fontDescriptionFromString: (str: string) => FontDescription
  * logical attributes can't be computed without context
  * (for example you need to see spaces on either side of
  * a word to know the word is a word).
- * @param text - text to process. Must be valid UTF-8
- * @param length - length in bytes of `text`
- * @param level - embedding level, or -1 if unknown
- * @param language - language tag
- * @param attrs - array with one
- * @param attrsLen - length of `attrs` array
  */
 export declare const getLogAttrs: (text: string, length: number, level: number, language: Language, attrs: Ref<LogAttr[]>, attrsLen: number) => void;
 /**
  * Returns the mirrored character of a Unicode character.
  *
  * Mirror characters are determined by the Unicode mirrored property.
- * @param ch - a Unicode character
- * @param mirroredCh - location to store the mirrored character
  */
-export declare const getMirrorChar: (ch: number, mirroredCh?: Ref<number>) => boolean;
+export declare const getMirrorChar: (ch: number, mirroredCh?: Ref<number> | null) => boolean;
 /**
  * Finds the gravity that best matches the rotation component
  * in a `PangoMatrix`.
- * @param matrix - a `PangoMatrix`
  */
-export declare const gravityGetForMatrix: (matrix?: Matrix) => Gravity;
+export declare const gravityGetForMatrix: (matrix?: Matrix | null) => Gravity;
 /**
  * Returns the gravity to use in laying out a `PangoItem`.
  *
@@ -494,9 +373,6 @@ export declare const gravityGetForMatrix: (matrix?: Matrix) => Gravity;
  * If `base_gravity` is %PANGO_GRAVITY_AUTO, it is first replaced with the
  * preferred gravity of `script`.  To get the preferred gravity of a script,
  * pass %PANGO_GRAVITY_AUTO and %PANGO_GRAVITY_HINT_STRONG in.
- * @param script - `PangoScript` to query
- * @param baseGravity - base gravity of the paragraph
- * @param hint - orientation hint
  */
 export declare const gravityGetForScript: (script: Script, baseGravity: Gravity, hint: GravityHint) => Gravity;
 /**
@@ -515,10 +391,6 @@ export declare const gravityGetForScript: (script: Script, baseGravity: Gravity,
  *
  * If `base_gravity` is %PANGO_GRAVITY_AUTO, it is first replaced with the
  * preferred gravity of `script`.
- * @param script - `PangoScript` to query
- * @param wide - %TRUE for wide characters as returned by g_unichar_iswide()
- * @param baseGravity - base gravity of the paragraph
- * @param hint - orientation hint
  */
 export declare const gravityGetForScriptAndWidth: (script: Script, wide: boolean, baseGravity: Gravity, hint: GravityHint) => Gravity;
 /**
@@ -527,7 +399,6 @@ export declare const gravityGetForScriptAndWidth: (script: Script, wide: boolean
  * Note that {@link Pango.Matrix.rotate} takes angle in degrees, not radians.
  * So, to call {@link Pango.Matrix,rotate} with the output of this function
  * you should multiply it by (180. / G_PI).
- * @param gravity - gravity to query, should not be %PANGO_GRAVITY_AUTO
  */
 export declare const gravityToRotation: (gravity: Gravity) => number;
 /**
@@ -537,7 +408,6 @@ export declare const gravityToRotation: (gravity: Gravity) => number;
  * as well as *bidi* formatting characters, and a few other ones.
  *
  * This is totally different from {@link GLib.unichar_iszerowidth} and is at best misnamed.
- * @param ch - a Unicode character
  */
 export declare const isZeroWidth: (ch: number) => boolean;
 /**
@@ -553,29 +423,16 @@ export declare const isZeroWidth: (ch: number) => boolean;
  * advanced to the range covering the position just after
  * `start_index` + `length`. (i.e. if itemizing in a loop, just keep passing
  * in the same `cached_iter`).
- * @param context - a structure holding information that affects
- * @param text - the text to itemize. Must be valid UTF-8
- * @param startIndex - first byte in `text` to process
- * @param length - the number of bytes (not characters) to process
- * @param attrs - the set of attributes that apply to `text`.
- * @param cachedIter - Cached attribute iterator
  */
-export declare const itemize: (context: Context, text: string, startIndex: number, length: number, attrs: AttrList, cachedIter?: AttrIterator) => Item[];
+export declare const itemize: (context: Context, text: string, startIndex: number, length: number, attrs: AttrList, cachedIter?: AttrIterator | null) => Item[];
 /**
  * Like `pango_itemize()`, but with an explicitly specified base direction.
  *
  * The base direction is used when computing bidirectional levels.
  * {@link itemize} gets the base direction from the `PangoContext`
  * (see {@link Pango.Context.set_base_dir}).
- * @param context - a structure holding information that affects
- * @param baseDir - base direction to use for bidirectional processing
- * @param text - the text to itemize.
- * @param startIndex - first byte in `text` to process
- * @param length - the number of bytes (not characters) to process
- * @param attrs - the set of attributes that apply to `text`.
- * @param cachedIter - Cached attribute iterator
  */
-export declare const itemizeWithBaseDir: (context: Context, baseDir: Direction, text: string, startIndex: number, length: number, attrs: AttrList, cachedIter?: AttrIterator) => Item[];
+export declare const itemizeWithBaseDir: (context: Context, baseDir: Direction, text: string, startIndex: number, length: number, attrs: AttrList, cachedIter?: AttrIterator | null) => Item[];
 /**
  * Convert a language tag to a `PangoLanguage`.
  *
@@ -589,9 +446,8 @@ export declare const itemizeWithBaseDir: (context: Context, baseDir: Direction,
  *
  * Use {@link Pango.Language.get_default} if you want to get the
  * `PangoLanguage` for the current locale of the process.
- * @param language - a string representing a language tag
  */
-export declare const languageFromString: (language?: string) => Language | null;
+export declare const languageFromString: (language?: string | null) => Language | null;
 /**
  * Returns the `PangoLanguage` for the current locale of the process.
  *
@@ -649,9 +505,6 @@ export declare const layoutDeserializeErrorQuark: () => number;
  *
  * If the input base direction is a weak direction, the direction of the
  * characters in the text will determine the final resolved direction.
- * @param text - the text to itemize.
- * @param length - the number of bytes (not characters) to process, or -1
- * @param pbaseDir - input base direction, and output resolved direction.
  */
 export declare const log2visGetEmbeddingLevels: (text: string, length: number, pbaseDir: Ref<Direction>) => number[];
 /**
@@ -661,12 +514,8 @@ export declare const log2visGetEmbeddingLevels: (text: string, length: number, p
  * use this function to get the list of attributes and text out of the
  * markup. This function will not free `context`, use {@link GLib.MarkupParseContext.free}
  * to do so.
- * @param context - A valid parse context that was returned from {@link markup_parser_new}
- * @param attrList - address of return location for a `PangoAttrList`
- * @param text - address of return location for text with tags stripped
- * @param accelChar - address of return location for accelerator char
  */
-export declare const markupParserFinish: (context: GLib.MarkupParseContext, attrList?: Ref<AttrList>, text?: Ref<string>, accelChar?: Ref<number>) => boolean;
+export declare const markupParserFinish: (context: GLib.MarkupParseContext, attrList?: Ref<AttrList> | null, text?: Ref<string> | null, accelChar?: Ref<number> | null) => boolean;
 /**
  * Incrementally parses marked-up text to create a plain-text string
  * and an attribute list.
@@ -690,7 +539,6 @@ export declare const markupParserFinish: (context: GLib.MarkupParseContext, attr
  * This function is designed for applications that read Pango markup
  * from streams. To simply parse a string containing Pango markup,
  * the {@link Pango.parse_markup} API is recommended instead.
- * @param accelMarker - character that precedes an accelerator, or 0 for none
  */
 export declare const markupParserNew: (accelMarker: number) => GLib.MarkupParseContext;
 /**
@@ -704,13 +552,8 @@ export declare const markupParserNew: (accelMarker: number) => GLib.MarkupParseC
  *
  * If failed and `possible_values` is not %NULL, returned string should
  * be freed using g_free().
- * @param type - enum type to parse, eg. %PANGO_TYPE_ELLIPSIZE_MODE
- * @param str - string to parse
- * @param value - integer to store the result in
- * @param warn - if %TRUE, issue a g_warning() on bad input
- * @param possibleValues - place to store list of possible
  */
-export declare const parseEnum: (type: number, warn: boolean, str?: string, value?: Ref<number>, possibleValues?: Ref<string>) => boolean;
+export declare const parseEnum: (type: number, warn: boolean, str?: string | null, value?: Ref<number> | null, possibleValues?: Ref<string> | null) => boolean;
 /**
  * Parses marked-up text to create a plain-text string and an attribute list.
  *
@@ -729,14 +572,8 @@ export declare const parseEnum: (type: number, warn: boolean, str?: string, valu
  *
  * If any error happens, none of the output arguments are touched except
  * for `error`.
- * @param markupText - markup to parse (see the Pango Markup docs)
- * @param length - length of `markup_text`, or -1 if nul-terminated
- * @param accelMarker - character that precedes an accelerator, or 0 for none
- * @param attrList - address of return location for a `PangoAttrList`
- * @param text - address of return location for text with tags stripped
- * @param accelChar - address of return location for accelerator char
  */
-export declare const parseMarkup: (markupText: string, length: number, accelMarker: number, attrList?: Ref<AttrList>, text?: Ref<string>, accelChar?: Ref<number>) => boolean;
+export declare const parseMarkup: (markupText: string, length: number, accelMarker: number, attrList?: Ref<AttrList> | null, text?: Ref<string> | null, accelChar?: Ref<number> | null) => boolean;
 /**
  * Parses a font stretch.
  *
@@ -745,9 +582,6 @@ export declare const parseMarkup: (markupText: string, length: number, accelMark
  * "semi_condensed", "normal", "semi_expanded", "expanded",
  * "extra_expanded" and "ultra_expanded". Case variations are
  * ignored and the '_' characters may be omitted.
- * @param str - a string to parse.
- * @param stretch - a `PangoStretch` to store the result in.
- * @param warn - if %TRUE, issue a g_warning() on bad input.
  */
 export declare const parseStretch: (str: string, stretch: Ref<Stretch>, warn: boolean) => boolean;
 /**
@@ -756,9 +590,6 @@ export declare const parseStretch: (str: string, stretch: Ref<Stretch>, warn: bo
  * The allowed values are "normal", "italic" and "oblique", case
  * variations being
  * ignored.
- * @param str - a string to parse.
- * @param style - a `PangoStyle` to store the result in.
- * @param warn - if %TRUE, issue a g_warning() on bad input.
  */
 export declare const parseStyle: (str: string, style: Ref<Style>, warn: boolean) => boolean;
 /**
@@ -767,9 +598,6 @@ export declare const parseStyle: (str: string, style: Ref<Style>, warn: boolean)
  * The allowed values are "normal", "small-caps", "all-small-caps",
  * "petite-caps", "all-petite-caps", "unicase" and "title-caps",
  * case variations being ignored.
- * @param str - a string to parse.
- * @param variant - a `PangoVariant` to store the result in.
- * @param warn - if %TRUE, issue a g_warning() on bad input.
  */
 export declare const parseVariant: (str: string, variant: Ref<Variant>, warn: boolean) => boolean;
 /**
@@ -778,9 +606,6 @@ export declare const parseVariant: (str: string, variant: Ref<Variant>, warn: bo
  * The allowed values are "heavy",
  * "ultrabold", "bold", "normal", "light", "ultraleight"
  * and integers. Case variations are ignored.
- * @param str - a string to parse.
- * @param weight - a `PangoWeight` to store the result in.
- * @param warn - if %TRUE, issue a g_warning() on bad input.
  */
 export declare const parseWeight: (str: string, weight: Ref<Weight>, warn: boolean) => boolean;
 /**
@@ -792,8 +617,6 @@ export declare const parseWeight: (str: string, weight: Ref<Weight>, warn: boole
  * Care is taken to make sure `thickness` is at least one pixel when this
  * function returns, but returned `position` may become zero as a result
  * of rounding.
- * @param thickness - pointer to the thickness of a line, in Pango units
- * @param position - corresponding position
  */
 export declare const quantizeLineGeometry: (thickness: Ref<number>, position: Ref<number>) => void;
 /**
@@ -805,10 +628,8 @@ export declare const quantizeLineGeometry: (thickness: Ref<number>, position: Re
  * '\' proceeding a line delimiter combines adjacent lines. A '\' proceeding
  * any other character is ignored and written into the output buffer
  * unmodified.
- * @param stream - a stdio stream
- * @param str - `GString` buffer into which to write the result
  */
-export declare const readLine: (str: GLib.String, stream?: number) => number;
+export declare const readLine: (str: GLib.String, stream?: number | null) => number;
 /**
  * Reorder items from logical order to visual order.
  *
@@ -816,17 +637,14 @@ export declare const readLine: (str: GLib.String, stream?: number) => number;
  * levels of the items. The original list is unmodified.
  *
  * (Please open a bug if you use this function.
- * It is not a particularly convenient interface, and the code
- * is duplicated elsewhere in Pango for that reason.)
- * @param items - a `GList` of `PangoItem`
+ *  It is not a particularly convenient interface, and the code
+ *  is duplicated elsewhere in Pango for that reason.)
  */
 export declare const reorderItems: (items: Item[]) => Item[];
 /**
  * Scans an integer.
  *
  * Leading white space is skipped.
- * @param pos - in/out string position
- * @param out - an int into which to write the result
  */
 export declare const scanInt: (pos: Ref<string>, out: Ref<number>) => boolean;
 /**
@@ -835,8 +653,6 @@ export declare const scanInt: (pos: Ref<string>, out: Ref<number>) => boolean;
  * The string may either be a sequence of non-white-space characters,
  * or a quoted string with '"'. Instead a quoted string, '\"' represents
  * a literal quote. Leading white space outside of quotes is skipped.
- * @param pos - in/out string position
- * @param out - a `GString` into which to write the result
  */
 export declare const scanString: (pos: Ref<string>, out: GLib.String) => boolean;
 /**
@@ -844,8 +660,6 @@ export declare const scanString: (pos: Ref<string>, out: GLib.String) => boolean
  *
  * A word consists of [A-Za-z_] followed by zero or more
  * [A-Za-z_0-9]. Leading white space is skipped.
- * @param pos - in/out string position
- * @param out - a `GString` into which to write the result
  */
 export declare const scanWord: (pos: Ref<string>, out: GLib.String) => boolean;
 /**
@@ -861,7 +675,6 @@ export declare const scanWord: (pos: Ref<string>, out: GLib.String) => boolean;
  * as `PangoScript`, as of Pango 1.18, this function simply returns
  * the return value of {@link GLib.unichar_get_script}. Callers must be
  * prepared to handle unknown values.
- * @param ch - a Unicode character
  */
 export declare const scriptForUnichar: (ch: number) => Script;
 /**
@@ -894,7 +707,6 @@ export declare const scriptForUnichar: (ch: number) => Script;
  * in an otherwise non-Arabic text. The same trick can be used to
  * choose a default language for %PANGO_SCRIPT_HAN when setting
  * context language is not feasible.
- * @param script - a `PangoScript`
  */
 export declare const scriptGetSampleLanguage: (script: Script) => Language | null;
 /**
@@ -916,12 +728,8 @@ export declare const scriptGetSampleLanguage: (script: Script) => Language | nul
  * {@link Pango.itemize} have indices that are relative to the entire paragraph,
  * so you need to subtract the item offset from their indices before
  * calling {@link Pango.shape}.
- * @param text - the text to process
- * @param length - the length (in bytes) of `text`
- * @param analysis - `PangoAnalysis` structure from {@link Pango.itemize}
- * @param glyphs - glyph string in which to store results
  */
-export declare const shape: (text: string, length: number, analysis: number, glyphs: GlyphString) => void;
+export declare const shape: (text: string, length: number, analysis: Analysis, glyphs: GlyphString) => void;
 /**
  * Convert the characters in `text` into glyphs.
  *
@@ -944,14 +752,8 @@ export declare const shape: (text: string, length: number, analysis: number, gly
  * so you do not pass the full paragraph text as `paragraph_text`, you need
  * to subtract the item offset from their indices before calling
  * {@link Pango.shape_full}.
- * @param itemText - valid UTF-8 text to shape.
- * @param itemLength - the length (in bytes) of `item_text`. -1 means nul-terminated text.
- * @param paragraphText - text of the paragraph (see details).
- * @param paragraphLength - the length (in bytes) of `paragraph_text`. -1 means nul-terminated text.
- * @param analysis - `PangoAnalysis` structure from {@link Pango.itemize}.
- * @param glyphs - glyph string in which to store results.
  */
-export declare const shapeFull: (itemText: string, itemLength: number, paragraphLength: number, analysis: number, glyphs: GlyphString, paragraphText?: string) => void;
+export declare const shapeFull: (itemText: string, itemLength: number, paragraphLength: number, analysis: Analysis, glyphs: GlyphString, paragraphText?: string | null) => void;
 /**
  * Convert the characters in `item` into glyphs.
  *
@@ -966,14 +768,8 @@ export declare const shapeFull: (itemText: string, itemLength: number, paragraph
  * so you do not pass the full paragraph text as `paragraph_text`, you need
  * to subtract the item offset from their indices before calling
  * {@link Pango.shape_with_flags}.
- * @param item - `PangoItem` to shape
- * @param paragraphText - text of the paragraph (see details).
- * @param paragraphLength - the length (in bytes) of `paragraph_text`.
- * @param logAttrs - array of `PangoLogAttr` for `item`
- * @param glyphs - glyph string in which to store results
- * @param flags - flags influencing the shaping process
  */
-export declare const shapeItem: (item: Item, paragraphLength: number, glyphs: GlyphString, flags: ShapeFlags, paragraphText?: string, logAttrs?: LogAttr) => void;
+export declare const shapeItem: (item: Item, paragraphLength: number, glyphs: GlyphString, flags: ShapeFlags, paragraphText?: string | null, logAttrs?: LogAttr | null) => void;
 /**
  * Convert the characters in `text` into glyphs.
  *
@@ -993,24 +789,13 @@ export declare const shapeItem: (item: Item, paragraphLength: number, glyphs: Gl
  * so you do not pass the full paragraph text as `paragraph_text`, you need
  * to subtract the item offset from their indices before calling
  * {@link Pango.shape_with_flags}.
- * @param itemText - valid UTF-8 text to shape
- * @param itemLength - the length (in bytes) of `item_text`.
- * @param paragraphText - text of the paragraph (see details).
- * @param paragraphLength - the length (in bytes) of `paragraph_text`.
- * @param analysis - `PangoAnalysis` structure from {@link Pango.itemize}
- * @param glyphs - glyph string in which to store results
- * @param flags - flags influencing the shaping process
- */
-export declare const shapeWithFlags: (itemText: string, itemLength: number, paragraphLength: number, analysis: number, glyphs: GlyphString, flags: ShapeFlags, paragraphText?: string) => void;
-/**
- * Skips 0 or more characters of white space.
- * @param pos - in/out string position
  */
+export declare const shapeWithFlags: (itemText: string, itemLength: number, paragraphLength: number, analysis: Analysis, glyphs: GlyphString, flags: ShapeFlags, paragraphText?: string | null) => void;
+/** Skips 0 or more characters of white space. */
 export declare const skipSpace: (pos: Ref<string>) => boolean;
 /**
  * Splits a %G_SEARCHPATH_SEPARATOR-separated list of files, stripping
  * white space and substituting ~/ with $HOME/.
- * @param str - a %G_SEARCHPATH_SEPARATOR separated list of filenames
  */
 export declare const splitFileList: (str: string) => string[];
 /**
@@ -1018,7 +803,6 @@ export declare const splitFileList: (str: string) => string[];
  *
  * This is the counterpart to {@link Pango.TabArray.to_string}.
  * See that functions for details about the format.
- * @param text - a string
  */
 export declare const tabArrayFromString: (text: string) => TabArray | null;
 /**
@@ -1031,18 +815,9 @@ export declare const tabArrayFromString: (text: string) => TabArray | null;
  *
  * Note that it is better to pass -1 for `offset` and use {@link Pango.attr_break}
  * to apply attributes to the whole paragraph.
- * @param text - text to process. Must be valid UTF-8
- * @param length - length in bytes of `text`
- * @param analysis - `PangoAnalysis` for `text`
- * @param offset - Byte offset of `text` from the beginning of the
- * @param attrs - array with one
- * @param attrsLen - length of `attrs` array
- */
-export declare const tailorBreak: (text: string, length: number, analysis: number, offset: number, attrs: Ref<LogAttr[]>, attrsLen: number) => void;
-/**
- * Trims leading and trailing whitespace from a string.
- * @param str - a string
  */
+export declare const tailorBreak: (text: string, length: number, analysis: Analysis, offset: number, attrs: Ref<LogAttr[]>, attrsLen: number) => void;
+/** Trims leading and trailing whitespace from a string. */
 export declare const trimString: (str: string) => string;
 /**
  * Determines the inherent direction of a character.
@@ -1054,7 +829,6 @@ export declare const trimString: (str: string) => string;
  * letters, right-to-left letters, and everything else. If full Unicode
  * bidirectional type of a character is needed, {@link Pango.BidiType.for_unichar}
  * can be used instead.
- * @param ch - a Unicode character
  */
 export declare const unicharDirection: (ch: number) => Direction;
 /**
@@ -1062,14 +836,12 @@ export declare const unicharDirection: (ch: number) => Direction;
  *
  * The conversion is done by multiplying `d` by %PANGO_SCALE and
  * rounding the result to nearest integer.
- * @param d - double floating-point value
  */
 export declare const unitsFromDouble: (d: number) => number;
 /**
  * Converts a number in Pango units to floating-point.
  *
  * The conversion is done by dividing `i` by %PANGO_SCALE.
- * @param i - value in Pango units
  */
 export declare const unitsToDouble: (i: number) => number;
 /**
@@ -1098,9 +870,6 @@ export declare const version: () => number;
  * (same major version.)
  *
  * For compile-time version checking use PANGO_VERSION_CHECK().
- * @param requiredMajor - the required major version
- * @param requiredMinor - the required minor version
- * @param requiredMicro - the required major version
  */
 export declare const versionCheck: (requiredMajor: number, requiredMinor: number, requiredMicro: number) => string | null;
 /**