[OS X TeX] pdflatex reman error

[Herbert Schulz]

> On Jul 11, 2020, at 6:39 PM, Peter Teeson via MacOSX-TeX <macosx-tex at email.esm.psu.edu> wrote:
> 
> Greetings:
> (1) The environment:
>      MacOS High Sierra 10.13.6; Xcode 10.1
>      Doxygen 1.8.18; 
>      Graphviz dot - graphviz version 2.45.20200705.1509 (20200705.1509);
>      TeX 3.14159265 (TeX Live 2020)
>       pdfTeX 3.14159265-2.6-1.40.21 (TeX Live 2020)
> 
> (2) Apple open source project: SampleUSBMIDIDriver.zip   <https://developer.apple.com/library/archive/samplecode/SampleUSBAudioOverrideDriver/Introduction/Intro.html#//apple_ref/doc/uid/DTS40009110>
> 
> TL:DNR
> Downloaded and successfully built the project; 
> Ran Doxygen - saved the log and the config; 
> Gandalf:~ pteeson$ cd to the /SampleUSBMIDIDriver/Doxygen/latex directory
> Gandalf:latex pteeson$ make
> rm -f *.ps *.dvi *.aux *.toc *.idx *.ind *.ilg *.log *.out *.brf *.blg *.bbl refman.pdf
> pdflatex refman
> 
> Got this error:
> 
> ! Package inputenc Error: Invalid UTF-8 byte "B5.
> 
> See the inputenc package documentation for explanation.
> Type  H <return>  for immediate help.
>  ...                                              
>                                                   
> l.182 ...the number of bytes per microframe (125 ?
>                                                   secs). If it is a full spe...
> 
> ? H 
> The document does not appear to be in UTF-8 encoding.
> Try adding \UseRawInputEncoding as the first line of the file
> or specify an encoding such as \usepackage [latin1]{inputenc}
> in the document preamble.
> Alternatively, save the file in UTF-8 using your editor or another tool
> ? 
> 
> (3) Saved the log and tracked the error down to some documentation in this header file
> /System/Library/Frameworks/IOKitFramework//Headers/usb/IOUSBLib.h at line 1857:
> "it will be the number of bytes per microframe (125 µsecs). If it is a full...”
> 
> (4) Checked the encoding of that file: 
> Gandalf:~ pteeson$ file -I /System/Library/Frameworks/IOKit.framework/Versions/A/Headers/usb/IOUSBLib.h 
> /System/Library/Frameworks/IOKit.framework/Versions/A/Headers/usb/IOUSBLib.h: text/html; charset=iso-8859-1
> 
> 
> So What?
> The character  µ (mu) 0xB5 is indeed not part of UTF-8! But it IS in ISO-8859-1- the documents encoding!!!!
> So how could this happen? Where could the error be?  pdflatex? Doxygen?
> 
> I have saved both the Doxygen and pdflatex logs and can put them up as gists if anyone rwants to gory details.
> 
> Thanks for your suggestions…..
> 
> respect…
> 
> Peter

Howdy,

If it's not UTF-8 encoded you have to tell pdflatex what encoding is being used by including the proper \usepackage[encoding]{inputenc} where `encoding' is one of many values for different encodings. Please run `texdoc inputenc` to see the documentation for the inputenc package.

Good Luck,

Herb Schulz
(herbs at wideopenwest dot com)