[texdoc] texdoc machine readable output

Manuel Pégourié-Gonnard mpg at elzevir.fr
Fri Nov 13 12:54:08 CET 2009


Manuel Pégourié-Gonnard a écrit :
>> foo	/path/a
>> foo	/path/b
>> bar	/path/c
>> bar	/path/d
>>
>> Also, if the name were always inserted, the output parsing would the
>> same regardless of how many args were passed.  Just an idea...as I
>> said, I'm only passing a single argument.
>>
> Why not. But what to do when there is no result for a particular
> argument? Just omit it? Anyway, I like the idea of making the output
> more homogeneous.
> 
Ok, I did that.

I also made another change, as a preparation for next version. So the
final (or so I hope) format is:

argument <tab> score <tab> filename

as in:

foo	1	/path/a
foo	0	/path/b
bar	1	/path/c

Currently the score doesn't mean anything, you can just consider it as
dummy values. But in future versions, there should be a scoring system
in texdoc, and the score will be a real value. (I intend to use this
info in coverage-check scripts, but maybe you'll want to use it in some
way too. I'll keep you informed when the score will become meaningful.)

By adding this now, I hope I can keep the output format stable in the
foreseeable future.

I hope the format is ok for you.

Manuel.



More information about the texdoc mailing list