Previous: Creating Topics, Up: Working with Topics [Contents][Index]
We call both issues and pull-requests "topics". The contributions to the conversation are called "posts". The post that initiated the conversation is also called a post.
These commands are available only from the topic buffer (i.e. from the
buffer that shows the posts on a topic). Other commands that also
work in other buffers are available here also. For example C-c C-w
on
a post visits that post in a browser.
forge-create-post
)forge-create-post
)This command allows users to create a new post on an existing topic.
It opens a buffer in which the user can write the post. When the
post is done, then the user has to submit using C-c C-c
.
If the region is active and marks part of an existing post, then that part of the post is quoted. Otherwise, or if a prefix argument is used, then the complete post that point is currently on is quoted.
forge-edit-post
)This command visits an existing post in a separate buffer. When the
changes to the post are done, then the user has to submit using C-c
C-c
.
forge-edit-topic-title
)This command reads a new title for an existing topic in the minibuffer.
forge-edit-topic-state
)This command toggles the state of an existing topic between "open" and "closed".
forge-edit-topic-labels
)This command reads a list of labels for an existing topic in the minibuffer.
forge-edit-topic-marks
)This command reads a list of marks for an existing topic in the minibuffer.
Marks are like labels except that they are not shared with anyone
else. To create a mark that topics can subsequently be marked with
use the command forge-create-mark
. Existing marks can be edited
using the command forge-edit-mark
.
forge-edit-topic-assignees
)This command reads a list of assignees for an existing topic in the minibuffer.
forge-edit-topic-review-requests
)This command reads a list of people who you would like to review an existing topic in the minibuffer.
forge-edit-topic-note
)forge-edit-topic-note
)This lets you edit your private note about a topic.
forge-delete-comment
)This command deletes the comment at point.
Creating a new post and editing an existing post are similar to creating a new commit and editing the message of an existing commit. In both cases the message has to be written in a separate buffer and then the process has to be finished or canceled using a separate command.
The following commands are available in buffers used to edit posts:
forge-post-submit
)This command submits the post that is being edited in the current buffer.
forge-post-cancel
)This command cancels the post that is being edited in the current buffer.
Previous: Creating Topics, Up: Working with Topics [Contents][Index]