Next: , Previous: , Up: Forge User and Developer Manual   [Contents][Index]


7 Creating Topics and Posts

We call both issues and pull-requests "topics". The contributions to the conversation are called "posts". The initial topic description is also called a post.

Creating a new topic or post and editing an existing post work similarly to now creating a new commit or editing the message of an existing commit works in Magit. 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 drop you into such a buffer.

N c p (forge-create-pullreq)
C-c C-n [on "Pull requests" section]

This command creates a new pull-request for the current repository.

N c i (forge-create-issue)
C-c C-n [on "Issues" section]

This command creates a new issue for the current repository.

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

This command creates a new post on an existing topic. It is only available in buffers that visit an existing topic.

If the region is active and marks part of an existing post, then that part of the post is quoted. When a prefix argument is used, then the complete post, which point is currently on, is quoted.

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.

C-c C-e (forge-post-dispatch)

This prefix command features the above two commands as suffixes, and when creating a pull-request also the following command. More suffix commands will likely be added in the future.

C-c C-e d (forge-post-toggle-draft)

This command toggles whether the pull-request being created is a draft.


Next: Editing Topics, Previous: Visiting Topics, Up: Forge User and Developer Manual   [Contents][Index]