[nfbcs] documents describing algorithms

Joseph C. Lininger devnull-nfbcs at pcdesk.net
Thu Nov 7 02:32:58 UTC 2013


Good eevening folks,
I'm working on some documentation describing cryptographic algorithms 
for a project I'm doing. The documents describe the algorithms, as well 
as some of my thoughts on implementing them and optimizing them and 
such. I wrote the documents to make it easier for me to write the code 
for them, since describing them made them clearer in my mind. Here's my 
question.

I am using LaTeX to typeset the documents so that they'll look good and 
have proper symbology and such. Well, one of the reasons I'm including 
these in my project is because it's so difficult to find algorithm 
descriptions that are easily read by blind people. It's not the only 
reason I'm doing it, but it is one of them. The pdf's I'm generating are 
not horible, but some of the symbols do not read well with screen 
readers. Is providing the LaTeX source good enough in that case? I don't 
do anything fancy, so someone could almost certainly figure out the 
algorithms and read my thoughts by reading the .tex file. Or do you guys 
think I should be doing something else? I'm probably not willing to 
translate to something like MathML because doing that would require me 
to write the document twice and I really don't want to do that. I 
suppose I could include an html version that would just read LaTeX for 
the math formulas. Any thoughts would be appreciated. Also, I have one 
document ready if anyone would like to take a look at it. It describes 
the Blowfish algorithm.
Joe




More information about the NFBCS mailing list