all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Tobias Geerinckx-Rice via Guix-patches via <guix-patches@gnu.org>
To: 40025@debbugs.gnu.org
Subject: [bug#40025] [PATCH] Add gitless package definition.
Date: Wed, 11 Mar 2020 20:05:27 +0100	[thread overview]
Message-ID: <87wo7qhfuw.fsf@nckx> (raw)
In-Reply-To: <20200311151137.32198-1-jboy@bius.moe>

[-- Attachment #1: Type: text/plain, Size: 2589 bytes --]

John,

Thanks for the patch!

Guix uses a specific commit message format.  It's partially 
documented in ‘(guix)Submitting Patches’ but you're IMO better off 
just reading the git history to get a feel for it.  Here's the 
commit message for this package:

    gnu: Add gitless.

    * gnu/packages/version-control.scm (gitless): New public 
    variable.

    Co-authored-by: Tobias Geerinckx-Rice <me@tobias.gr>

I've written down my comments below, but you don't need to send a 
V2.

I'll try to make it work here and will push a modified version if 
I succeed.  It would be nice if I could get rid of propagation, 
and the path to a (non-native) git still needs to be embedded so 
the user doesn't need to install git themselves.

> +       (uri (git-reference
> +             (url "https://github.com/gitless-vcs/gitless")
> +             (commit (string-append "v" version))))

This is missing the FILE-NAME field.  Without it, the source is 
checked out into /gnu/store/<hash>-checkout/ which makes it harder 
to see what's what.

Adding (file-name (git-file-name name version)) puts it in 
/gnu/store/<hash>-gitless-<version>-checkout.

> +	     (substitute* "requirements.txt"
> +	       (("pygit2==") "pygit2>="))

This has no effect on the end result so I suggest we drop it 
again.

> + (synopsis
> +  "A version control system built on top of Git")

Synopses shouldn't start with an article.

Tip: running ‘./pre-inst-env guix lint gitless’ will catch things 
like this.  It also caught the missing FILE-NAME.

It also printed several warnings about using tabs instead of 
spaces.  Guix does not use tabs in Scheme code.

> +    (description
> +     "A version control system built on top of Git")

This is waaay too short, I told you that before :-p  Moreover, 
descriptions should consist of complete sentences.  I've knocked 
something together based on the home page blurb:

  Gitless is a Git-compatible version control system that aims to 
  be
  easy to learn and use.  It simplifies the common workflow by
  committing changes to tracked files by default and saving any
  uncommitted changes as part of a branch.

  The friendly @command{gl} command-line interface gives feedback 
  and
  helps you figure out what to do next.

  Gitless is implemented on top of Git and its commits and 
  repositories
  are indistinguishable from Git's.  You (or other contributors) 
  can
  always fall back on @command{git}, and use any regular Git 
  hosting
  service.

Kind regards,

T G-R

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 832 bytes --]

  reply	other threads:[~2020-03-11 19:05 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-03-11 15:11 [bug#40025] [PATCH] Add gitless package definition John D. Boy
2020-03-11 19:05 ` Tobias Geerinckx-Rice via Guix-patches via [this message]
2020-03-12  4:17   ` bug#40025: " Tobias Geerinckx-Rice via Guix-patches via

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87wo7qhfuw.fsf@nckx \
    --to=guix-patches@gnu.org \
    --cc=40025@debbugs.gnu.org \
    --cc=me@tobias.gr \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/guix.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.