4.3.4 Editing Topics and Posts

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.

C-c C-n     (forge-create-post)

C-c C-r     (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 sumbit using C-c C-c.

C-c C-e [on a post section]     (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 sumbit using C-c C-c.

C-c C-e [on "Title" section]     (forge-edit-topic-title)

This command reads a new title for an existing topic in the minibuffer.

C-c C-e [on "State" section]     (forge-edit-topic-state)

This command toggles the state of an existing topic between "open" and "closed".

C-c C-e [on "Labels" section]     (forge-edit-topic-labels)

This command reads a list of labels for an existing topic in the minibuffer.

C-c C-e [on "Assignees" section]     (forge-edit-topic-assignees)

This command reads a list of assignees for an existing topic in the minibuffer.

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:

C-c C-c     (forge-post-submit)

This command submits the post that is being edited in the current buffer.

C-c C-k     (forge-post-cancel)

This command cancels the post that is being edited in the current buffer.