package crs

  1. Overview
  2. Docs
A tool for managing inline review comments embedded in source code

Install 

dune-project
 Dependency

github.com Readme Changelog Edit opam file Versions (4)

Authors

  1. M
    Mathieu Barbin

Maintainers

  1. M
    Mathieu Barbin <opensource@mbarbin.org>

Sources

crs-0.0.20260307.tbz
sha256=77f77c61e908a6716fa876f5648f662ffaf7e24be4a7889fd6b53121592311bb
sha512=5fc6252650571c4127ebb1e61fecf78c5d4ce35e2832dff47125cda1448e07ea6d4da5e3a9a28643e3491d3594b0ee8857214241f98bd0296ada2c35ea8daa4b

doc/crs.cr-comment/Cr_comment/index.html

Module Cr_commentSource

Sourcemodule Status : sig ... end
Sourcemodule Filter : sig ... end

A type to select only a subset of CRs.

Sourcemodule Priority : sig ... end
Sourcemodule Qualifier : sig ... end
Sourcemodule User_handle : sig ... end

A user handle as it appears in CR comments and related metadata (such as pull request author).

Sourcemodule Digest_hex : sig ... end
Sourcemodule Header : sig ... end
Sourcetype t

A Cr_comment.t is an immutable value holding the information and metadata about a CR that was parsed from a file.

Sourceval equal : t -> t -> bool
Sourceval to_dyn : t -> Crs_stdlib.Dyn.t

Getters

Sourceval content : t -> string

content is the text of the CR with comment markers removed from the beginning and end (if applicable). See also reindented_content.

Sourceval content_start_offset : t -> int

This is the offset in the original file at which the content field started. This is useful if you need to reparse the content of CRs dynamically while being able to build locations.

Sourceval comment_prefix : t -> string

This is the leading string that contains the comment markers on the left of the content field, stripped. This may be useful when linting comments and working on CR formatting.

Sourceval whole_loc : t -> Loc.t

whole_loc is suitable for removal of the entire CR comment. It includes the comments boundaries from path as well.

Sourceval status : t -> Status.t
Sourceval priority : t -> Priority.t

priority t represents the expectation as to when work on the CR is meant to happen. It is based on the header's qualifier except that XCRs and invalid CRs are meant to be worked on Now.

Sourceval digest_ignoring_minor_text_changes : t -> Digest_hex.t

This digest is computed such that changes in positions in a file, or changes in whitespaces are ignored. It is used by downstream systems to detect that two CRs are equivalent, which in turn may affect when a CR is active.

Print

Sourceval to_string : t -> string

Show the CR with a line showing the file position.

Sourceval reindented_content : ?new_line_prefix:string -> t -> string

reindented_content t returns the content of the CR with leading indentation removed or normalized. This is useful for displaying multiple CRs together in a unified format, such as in crs grep. new_line_prefix allows to control the indentation or margin used to produce the new output. It defaults to "". Trailing whitespace are removed from new_line_prefix as needed.

Sourceval output_list : t list -> oc:Out_channel.t -> unit

Sorts the supplied list of CRs and outputs it to the supplied out channel, separated by newline characters.

Sourceval print_list : t list -> unit

A convenient wrapper for output_list that prints to stdout.

Sort

Sourcemodule For_sorted_output : sig ... end
Sourceval sort : t list -> t list

Private

This module is exported to be used by libraries with strong ties to cr_comment. Its signature may change in breaking ways at any time without prior notice, and outside the guidelines set by semver.

In particular, the intention here is that CRs may only be created using dedicated helpers libraries that are defined in this project, parsing them from files in vcs trees.

Sourcemodule Private : sig ... end

Deprecated

The following is deprecated. Please migrate, and do not use in new code.

Sourceval work_on : t -> Priority.t

This was renamed priority. Hint: Run ocamlmig migrate.

  • deprecated [since 2025-10] Use [Cr_comment.priority]. Hint: Run [ocamlmig migrate]
Sourceval kind : t -> Status.t

This was renamed status. Hint: Run ocamlmig migrate.

  • deprecated [since 2025-10] Use [Cr_comment.status]. Hint: Run [ocamlmig migrate]
Sourcemodule Std : sig ... end