View Single Post
Old 11-26-2015, 12:38 AM   #19
eschwartz
Ex-Helpdesk Junkie
eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.eschwartz ought to be getting tired of karma fortunes by now.
 
eschwartz's Avatar
 
Posts: 19,421
Karma: 85400180
Join Date: Nov 2012
Location: The Beaten Path, USA, Roundworld, This Side of Infinity
Device: Kindle Touch fw5.3.7 (Wifi only)
Quote:
Originally Posted by tekwrite View Post
As a Technical Writer of 25 years, I stand by my comment. And what is this? "custom series column"? Very vague attempt at saying "user-defined column" wouldn't you say? Otherwise I probably would have found that single example.
"custom" is pretty obviously a reference to the same concept as "user-defined".

The official calibre term for it is a "custom column", not a "user-defined column".


Either way, and regardless of your assumptions vs. established calibre practice, it is obvious IMHO to anyone who spends the time trying to internalize the words of the manual; conversely, someone who glosses through it looking for highlighted words to stand out, is likely to miss a lot of information.

Nevertheless, if you feel you can do better, calibre is open-source and so is the User Guide.
Since you are apparently skilled at writing documentation, why don't you volunteer to clarify calibre's manual? (No, that was not a joke. Writing documentation isn't easy and I am sure if you can improve on it Kovid will be grateful.)

Quote:
ALL of the non custom field searches are highlighted in a different color. The only custom search syntax is buried in the body of the paragraph. Not very consistent.
That's a very confusing statement to make, because looking at the manual, the custom search syntax is highlighted exactly the same as the non custom field searches.
Although as it only mentions the lookup names, that is all that is highlighted...
eschwartz is offline   Reply With Quote