mirror of
https://github.com/git-for-windows/git.git
synced 2026-06-30 10:57:06 -05:00
9759608622
The Git project is not exactly the easiest project to get started in: it's written in C and POSIX shell, with bits of Perl, Rust and other languages sprinkled into it. On top of that, the project has grown somewhat organically over time, making the codebase hard to navigate. These are problems that we're aware of, and there have been and still are efforts to clean up some of the technical debt that is natural to exist an a project that is more than 20 years old. Furthermore, we provide resources to newcomers that help them out like our coding guidelines, code of conduct or "MyFirstContribution.adoc". But there is a rather practical problem: finding your way around in our project's tree is not easy. Doing a directory listing in the top-level directory will present you with more than 550 files, which makes it extremely hard for a newcomer to figure out what files they are even supposed to look at. This makes the onboarding experience somewhat harder than it really needs to be. This isn't only a problem for newcomers though, as I myself struggle to find the files I am looking for because of the sheer number of files. Besides the problem of discoverability it also creates a problem of structure. It is not obvious at all which files are part of "libgit.a" and which files are only linked into our final executables. So while we have this split in our build systems, that split is not evident at all in our tree. Introduce a new "lib/" directory and move all of our sources for "libgit.a" into it to fix these issues. It makes the split we have evident and reduces the number of files in our top-level tree from 550 files to ~80 files. This is still a lot of files, but it's significantly easier to navigate already. Furthermore, we can further iterate after this step and think about introducing a better structure for remaining files, as well. Signed-off-by: Patrick Steinhardt <ps@pks.im> Signed-off-by: Junio C Hamano <gitster@pobox.com>
78 lines
2.3 KiB
C
78 lines
2.3 KiB
C
#ifndef REFLOG_H
|
|
#define REFLOG_H
|
|
#include "refs.h"
|
|
|
|
#define REFLOG_EXPIRE_TOTAL (1 << 0)
|
|
#define REFLOG_EXPIRE_UNREACH (1 << 1)
|
|
|
|
struct reflog_expire_entry_option {
|
|
struct reflog_expire_entry_option *next;
|
|
timestamp_t expire_total;
|
|
timestamp_t expire_unreachable;
|
|
char pattern[FLEX_ARRAY];
|
|
};
|
|
|
|
struct reflog_expire_options {
|
|
struct reflog_expire_entry_option *entries, **entries_tail;
|
|
int stalefix;
|
|
int explicit_expiry;
|
|
timestamp_t default_expire_total;
|
|
timestamp_t expire_total;
|
|
timestamp_t default_expire_unreachable;
|
|
timestamp_t expire_unreachable;
|
|
int recno;
|
|
};
|
|
#define REFLOG_EXPIRE_OPTIONS_INIT(now) { \
|
|
.default_expire_total = now - 30 * 24 * 3600, \
|
|
.default_expire_unreachable = now - 90 * 24 * 3600, \
|
|
}
|
|
|
|
/*
|
|
* Parse the reflog expire configuration. This should be used with
|
|
* `repo_config()`.
|
|
*/
|
|
int reflog_expire_config(const char *var, const char *value,
|
|
const struct config_context *ctx, void *cb);
|
|
|
|
void reflog_clear_expire_config(struct reflog_expire_options *opts);
|
|
|
|
/*
|
|
* Adapt the options so that they apply to the given refname. This applies any
|
|
* per-reference reflog expiry configuration that may exist to the options.
|
|
*/
|
|
void reflog_expire_options_set_refname(struct reflog_expire_options *cb,
|
|
const char *refname);
|
|
|
|
struct expire_reflog_policy_cb {
|
|
enum {
|
|
UE_NORMAL,
|
|
UE_ALWAYS,
|
|
UE_HEAD
|
|
} unreachable_expire_kind;
|
|
struct commit_list *mark_list;
|
|
unsigned long mark_limit;
|
|
struct reflog_expire_options opts;
|
|
struct commit *tip_commit;
|
|
struct commit_list *tips;
|
|
unsigned int dry_run:1;
|
|
};
|
|
|
|
int reflog_delete(const char *rev, enum expire_reflog_flags flags,
|
|
int verbose);
|
|
void reflog_expiry_cleanup(void *cb_data);
|
|
void reflog_expiry_prepare(const char *refname, const struct object_id *oid,
|
|
void *cb_data);
|
|
int should_expire_reflog_ent(struct object_id *ooid, struct object_id *noid,
|
|
const char *email, timestamp_t timestamp, int tz,
|
|
const char *message, void *cb_data);
|
|
int count_reflog_ent(const char *refname,
|
|
struct object_id *ooid, struct object_id *noid,
|
|
const char *email, timestamp_t timestamp, int tz,
|
|
const char *message, void *cb_data);
|
|
int should_expire_reflog_ent_verbose(struct object_id *ooid,
|
|
struct object_id *noid,
|
|
const char *email,
|
|
timestamp_t timestamp, int tz,
|
|
const char *message, void *cb_data);
|
|
#endif /* REFLOG_H */
|