|
libfossil
|
Configuration parameters for fsl_repo_create(). More...
#include "repo.h"
Data Fields | |
| bool | allowOverwrite |
| If false, fsl_repo_create() will fail if this->filename already exists. | |
| char const * | commitMessage |
| The comment text used for the initial commit. | |
| char const * | commitMessageMimetype |
| Mime type for the commit message (manifest N-card). | |
| char const * | configRepo |
| If not NULL and not empty, fsl_repo_create() will use this repository database to copy the configuration, copying over the following settings: | |
| bool | elideProjectCode |
| If true, the new repo will not have a "project-code" config entry. | |
| char const * | filename |
| The file name for the new repository. | |
| char const * | username |
| Fossil user name for the admin user in the new repo. | |
Configuration parameters for fsl_repo_create().
Always copy-construct these from fsl_repo_create_opt_empty resp. fsl_repo_create_opt_empty_m in order to ensure proper behaviour vis-a-vis default values.
TODOs:
| bool fsl_repo_create_opt::allowOverwrite |
If false, fsl_repo_create() will fail if this->filename already exists.
| char const* fsl_repo_create_opt::commitMessage |
The comment text used for the initial commit.
If NULL or empty (starts with a NUL byte) then no initial check is created. fossil(1) is largely untested with that scenario (but it seems to work), so for compatibility it is not recommended that this be set to NULL.
The default value (when copy-initialized) is "egg". There's a story behind the use of "egg" as the initial checkin comment, and it all started with a typo: "initial chicken"
| char const* fsl_repo_create_opt::commitMessageMimetype |
Mime type for the commit message (manifest N-card).
Manifests support this but fossil(1) has never (as of 2025-07) made use of it. It is provided for completeness but should, for compatibility's sake, probably not be set, as the fossil UI may not honor it. The implied default is text/x-fossil-wiki. Other ostensibly legal values include text/plain and text/x-markdown. This API will accept any value, but results are technically undefined with any values other than those listed above.
| char const* fsl_repo_create_opt::configRepo |
If not NULL and not empty, fsl_repo_create() will use this repository database to copy the configuration, copying over the following settings:
| bool fsl_repo_create_opt::elideProjectCode |
| char const* fsl_repo_create_opt::filename |
| char const* fsl_repo_create_opt::username |
Fossil user name for the admin user in the new repo.
If NULL, defaults to the Fossil context's user (see fsl_cx_user_get()). If that is NULL, it defaults to "root" for historical reasons.