File Content Extraction 25.4
Filter SDK C Programming Guide

# Control Hyphenation

There are two types of hyphens in a PDF document:

- A soft hyphen is added to a word by a word processor to divide the word across two lines. This is a discretionary hyphen and is used to ensure proper text flow in justified text.
- A hard hyphen is intentionally added to a word regardless of the word's position in the text flow. It is required by the rules of grammar or word usage. For example, compound words (such as three-week vacation and self-confident) contain hard hyphens.

By default, File Content Extraction ignores soft hyphens in the source document, to provide more searchable text content. However, if you want to maintain the document layout, you can keep soft hyphens in the Filter output.

To output soft hyphens from PDF documents

- In the C API, call the fpSetConfig() function with the following arguments:

  Argument | Parameter
  --- | ---
  `nType` | `KVFLT_KEEPSOFTHYPHEN`
  `nValue` | `TRUE`
  `pData` | `NULL`

  For example:

      (*fpSetConfig)(pKVFilter, KVFLT_KEEPSOFTHYPHEN, TRUE, NULL);

- In the `formats.ini` configuration file, set the following parameter:

      [pdf_flags]
      keepsofthyphen=TRUE

  (This is an alternative approach - you do not need to do this if you have configured this feature through the API).

Copyright 1997-2025 Open Text
Version 25.4 | Last updated October 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: File Content Extraction 25.4

Topic Title: Control Hyphenation