Red Hat Bugzilla – Bug 861225
API documentation missing critical info in system.config.createOrUpdatePath
Last modified: 2012-11-01 12:22:49 EDT
Description of problem:
On http://spacewalk.redhat.com/documentation/api/1.7/handlers/ServerConfigHandler.html#createOrUpdatePath , there's a missing value in the path_info struct, 'binary'. It is documented in the source:
* #struct("path info")
* #prop_desc("boolean", "binary", "mark the binary content, if True,
* base64 encoded content is expected (only for non-directories)")
Without this the uploaded files are treated as text by the spacewalk server and rendered unusable.
The binary value was added in commit b77a05778a707b5fb12b932b78e44d01f3a188de. Therefore it is currently in Spacewalk master (and nightly builds) and not in Spacewalk 1.7. So, it's correct that it is not listed in the api/1.7/handlers API overview -- it will not work on Spacewalk 1.7.
When Spacewalk 1.8 is out, the API documentation will be generated and added to the api/1.8 directory.