The revert command

[Owl]

So how does one use this command, exactly? It used to be quite easy, but with a new stuff on a server, it's a little more complicated.

!revert (xnum) (#ID) (-player) (team)

Lulwhat?

[Rocinante]

Code Select Expand

< jabrwock> !help: help for '!revert':
< jabrwock>  Function: revert one or more buildlog events, optionally of only one team
< jabrwock>  Syntax: !revert (xnum) (#ID) (-player) (team)
< jabrwock>  Flag: 'v'
< jabrwock> maybe some examples would be helpful
< Lakitu7> Most simple way is !revert x3 h   = revert last 3 things on the humans
< Lakitu7> All-in-one example:   !revert #20 x3 -unnamedplayer h    = start at event #20, revert 3 things by unnamedplayer on humans

It's a bit confusing, but quite powerful.  And the help & docs might be rewritten before Lakitu releases the QVM as a whole, but he's been busy with other things lately.

[Lakitu7]

I didn't know Ben had gone ahead and released anything with the new syntax. I mean, it's sort of ready but we could have used to clean up the help and such more first.

Oh well. When I do qvm release I'll have a good writup in MY docs, anyway.

[benmachine]

I realise that the syntax is confusing but people kept asking for features and what I did seemed the best way to accommodate them all.

My documentation is here:

http://www.bandstand.org.uk/~benm/coding/done.php#buildlog-revert

[doomagent13]

You should probably make it parse arguements in such a way that it can still handle the old format.

Btw, did you fix the inconsistencies in it? (!revert 10h would only revert 1 buildable)

And could you make teh buildlog store !reverts, maybe at teh front?

[Lakitu7]

xnum is roughly the old format. It was changed to be "broken" on purpose because so much was changed that it shouldn't be used blindly with the old syntax anymore. Consider this the "read the help before proceeding" point.

It should be better at parsing the h and a at different locations, but it's still best to just put them at the end with a space separation

The last one I can't answer for him.

[benmachine]

Lakitu's right about the old syntax. With regards to "does X work", try it and see.

And could you make teh buildlog store !reverts, maybe at teh front?

No. Often, I'll revert some decon, and realise some buildables are still missing - so I'll want to be able to 'pick up where I left off' as it were. Putting reverts in the buildlog would only serve to confuse, especially if one were alowed to revert those reverts.

!undo and !redo have been considered, however things are already damned complicated.

[doomagent13]

I was thinking more along the lines of to be able to re!revert.  There have been times when !revert would print the success message but not actually make the buildable.

[kevlarman]

use the console, then you can always repeat a command with a simple up+enter

[Paradox]

A good command would be !undo and !undolog...