There are only two necessary move operations: the "m" operation for moving entries and the "M" operation for moving the current group. all the possible kinds of moving, deleting and cloning of entries and groups be can done with just these two. The local move operations are not necessary but make moving within the current group a little easier. Cloning is done, in effect, by moving an entry or group into itself. Deleting, in effect, is done by moving an entry or group to the zzzap group.
You can move an entry from any group to any other group or subgroup. Once again, a group itself is just another entry and so moving a group around is equivalent to moving a non-group entry. Note that moving a group entry with either the "m" or "M" operation it can moved to any other group or be promoted to a top level group, See section Moving current group.
If you move an entry to the same group that it is in then instead of physically moving the entry into itself it clones the entry, See section Cloning Entries and Groups. Agroups prevents the user from moving any group entry inside itself. When you move an entry to the zzzap group it implies that you intend to delete it later, See section Zzzap Group.
You move an entry with the operation
Move an entry in current group to another group (keys: m)
KA KO m x
would move an entry x to some group that Agroups will prompt for at this point. When an entry is moved it is always moved to a target group. The target group can be a top level group or any subgroup.
When you move an entry to a group that has a subgroup Agroups notices this and asks whether you want to move it to the group proper or a subgroup. Lets say that we are moving an entry from some group to a group called "Test" and the Test group has subgroups. We would then see
There are subgroups in this group: Test 0 = Select this group as target group 1 = Select a subgroup of this group as target group
If we accept 0, the default here, then the entry being moved would be moved to the target group Test. If we chose 1 here then we would asked to choose the subgroup entry as the target group. This can go on and on recursively to as many depths of subgroups that we may have.
You can move the current group with the operation
Move current group to another group (keys: M)
Moving a top level group to the zzzap group is the first step in removing that top level group. When a top level group is moved to itself it is cloned, See section Cloning Entries and Groups. Note that this operation like all others that apply to groups, can be applied to a group other than the current group for one time, See section Current Group One Time. For example typing
KA KG g s KO M
would move a subgroup s of top level group g instead of the current group.
Whether you move any group or the current group using the "m" or "M" operation respectively, if that group is a subgroup then you will have the option of moving that subgroup to another group or promoting that subgroup as a top level group. Agroups automatically detects that you are moving a subgroup and gives you the prompt
You have elected to move a nested group entry. There are two options: 0 = Move this group entry to another group 1 = Promote this group entry as a top level group
If you choose option 1 and promote the group as a top level group Agroups assumes that you want to do something with it and so makes it the current group.
The two local move operations are
Move Locally an entry in current group (keys: l) Move Locally an entry in current group to its parent (keys: L)
As mentioned above these local move operations are not necessary and can be done with regular move operations, but they make it easier to do local moves within the current group. The "l" operation moves an entry in the current group into the current group. So it makes it easy to move an entry in the current group into a subgroup of the current group or clone an entry in the current group.
The "L" operation will move an entry in the current group up to the parent group of the current group. Note that as with the regular move operations only a group type entry can be promoted to a top level group. Also note for the "L" operation the Current Group One Time concept applies here, See section Current Group One Time. So for example, you can use the "L" operation to move an entry in a current group subgroup up to the current group, specifically
KA s KO L e
would move an entry "e" from inside the subgroup "s" in the current group up to the current group.
In the previous sections on moving entries and groups we mentioned that when an entry is moved to the same group that it is in or a top level group moved to itself, then it is cloned. When an entry is cloned in this way the clone becomes an entry of the same group as the original. It follows that when a top level group is cloned, the clone group becomes another top level group. When a top level group is cloned the cloned group becomes the current group.
Cloning entries is essentially the process of making an exact copy of an entry or group. Sometimes this is a very useful thing to do since frequently the user wants exactly the same action with just some minor differences. It is also useful to save an entry before experimenting with its original. Cloning a group can be useful for various things also. For example when breaking up a group into two groups it may be easier to clone the group and edit out pieces of each. As usual, in other Agroups capabilities, it is up to the user as how to get creative with cloning.
When an entry or group is cloned, the clone will prompt for an new id with the original id plus the word CLONE at the end as a default. You can just accept the default or edit the default id in the minibuffer. Agroups will also ask you for a new accelerator keys component, since it assumes that you want to have distinct keys between the clone and the original. All other components in the clone entry are exactly copies of the original components. And when cloning groups all sub-entries are copied recursively.
Go to the first, previous, next, last section, table of contents.