Method

GgitRefset_target

Declaration [src]

GgitRef*
ggit_ref_set_target (
  GgitRef* ref,
  GgitOId* oid,
  const gchar* log_message,
  GError** error
)

Description [src]

Create a new reference with the same name as the given reference but a different OID target. The reference must be a direct reference, otherwise this will fail.

The new reference will be written to disk, overwriting the given reference.

Parameters

oid GgitOId
 

A GgitOId.

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

The one line long message to be appended to the reflog.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
error GError **
  The return location for a GError*, or NULL.

Return value

Returns: GgitRef
 

The newly created GgitRef or NULL.

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