Method

GgitRepositorycreate_commit_from_ids

Declaration [src]

GgitOId*
ggit_repository_create_commit_from_ids (
  GgitRepository* repository,
  const gchar* update_ref,
  GgitSignature* author,
  GgitSignature* committer,
  const gchar* message_encoding,
  const gchar* message,
  GgitOId* tree,
  GgitOId** parents,
  gint parent_count,
  GError** error
)

Description [src]

Create a new commit. If update_ref is not NULL, the given reference will be updated to point to the newly created commit. Use “HEAD” to update the HEAD of the current branch and make it point to this commit.

If message_encoding is set to NULL, “UTF-8” encoding is assumed for the provided message. Note that message will not be cleaned up automatically. You can use #ggit_message_prettify to do this yourself if needed.

Parameters

update_ref const gchar*
 

Name of the reference to update.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
author GgitSignature
 

Author signature.

 The data is owned by the caller of the function.
committer GgitSignature
 

Committer signature (and time of commit).

 The data is owned by the caller of the function.
message_encoding const gchar*
 

Message encoding.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
message const gchar*
 

Commit message.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
tree GgitOId
 

The tree of objects to commit.

 The data is owned by the caller of the function.
parents An array of GgitOId*
 

Parent commits.

 The length of the array is specified in the parent_count argument.
 The data is owned by the caller of the function.
parent_count gint
 

Number of parent commits in parents.

error GError **
  The return location for a GError*, or NULL.

Return value

Returns: GgitOId
 

The GgitOId of the created commit object, or NULL in case of an error.

 The caller of the method takes ownership of the data, and is responsible for freeing it.
 The return value can be NULL.