[Piuparts-devel] pull: for-holger + feat/split-dwke

[Andreas Beckmann]

On 2014-02-10 12:40, Holger Levsen wrote:
> Hi,
> 
> On Montag, 10. Februar 2014, Andreas Beckmann wrote:
>> The documentation is the code :-)
> 
> no. thats a lie. and/or propaganda.
> 
>> I don't want to write a lot of protocol definition for README_server.txt
>> for commands the nobody (besides me) is ever going to use again, and
>> probably even I won't need them in this form again.
> 
> if noone is ever gonna use it again, it shouldnt be there. if it's to be used, 
> it should be docuemnted.

What would you like to see documented? These commands dump internal
state of the PackagesDB after the package status has been computed. And
this information is only useful if you know about the inner details of
the PackagesDB - which is not documented anywhere besides the code,
which is fine for implementation details.
The only way to use them is running piuparts-master manually, which is
not documented either. These commands have been helpful while debugging
all the status resolution problems (at the times we still had
circular-depends and friends) and will serve as templates for future
debugging tasks, that will probably need different information.


Andreas