improved code comments

This commit is contained in:
kim 2025-03-31 15:39:15 +01:00
commit 5bab57226e

View file

@ -293,7 +293,7 @@ func (t *StatusTimeline) Init(cap int) {
}, },
}) })
// Create a fast index lookup ptrs. // Get fast index lookup ptrs.
t.idx_ID = t.cache.Index("ID") t.idx_ID = t.cache.Index("ID")
t.idx_AccountID = t.cache.Index("AccountID") t.idx_AccountID = t.cache.Index("AccountID")
t.idx_BoostOfID = t.cache.Index("BoostOfID") t.idx_BoostOfID = t.cache.Index("BoostOfID")
@ -386,8 +386,8 @@ func (t *StatusTimeline) Load(
) )
// Before any further loading, // Before any further loading,
// store current lo,hi values, // store current lo, hi values
// used for possible return. // as possible lo, hi returns.
lo = metas[len(metas)-1].ID lo = metas[len(metas)-1].ID
hi = metas[0].ID hi = metas[0].ID
@ -471,12 +471,13 @@ func (t *StatusTimeline) Load(
} }
} }
// Returned frontend API models. // Prepare frontend API models.
var apiStatuses []*apimodel.Status var apiStatuses []*apimodel.Status
if len(metas) > 0 { if len(metas) > 0 {
switch { switch {
case len(metas) <= lim: case len(metas) <= lim:
// nothing to do // We have under
// expected limit.
case ord.Ascending(): case ord.Ascending():
// Ascending order was requested // Ascending order was requested
@ -484,8 +485,7 @@ func (t *StatusTimeline) Load(
// trim extra metadata from end. // trim extra metadata from end.
metas = metas[:lim] metas = metas[:lim]
// descending default: /* i.e. descending */
default:
// Descending order was requested // Descending order was requested
// and we have more than limit, so // and we have more than limit, so
// trim extra metadata from start. // trim extra metadata from start.
@ -496,13 +496,14 @@ func (t *StatusTimeline) Load(
apiStatuses = prepareStatuses(ctx, metas, prepareAPI) apiStatuses = prepareStatuses(ctx, metas, prepareAPI)
if hi == "" { if hi == "" {
// Only set hi value if not // No cached statuses were previously
// already set, i.e. we never // loaded, we need to determine a hi
// fetched any cached values. // paging value from recently loaded.
hi = metas[0].ID hi = metas[0].ID
} }
// Set lo value from fetched. // In case extra statuses were loaded,
// set lo paging value to last value.
lo = metas[len(metas)-1].ID lo = metas[len(metas)-1].ID
} }