Project

General

Profile

Feature #1073

RelNotes: current version or all previous versions?

Added by John Abbott almost 7 years ago. Updated over 6 years ago.

Status:
Closed
Priority:
Normal
Assignee:
Anna Maria Bigatti
Category:
Manual/documentation
Target version:
CoCoA-5.2.2
Start date:
22 May 2017
Due date:
% Done:

100%

Estimated time:
1.51 h
Spent time:
1.40 h

Description

Currently RelNotes() prints out the release notes for all previous versions of CoCoA-5.

I think it could be helpful to be able to limit how much it prints out e.g. just the most recent entry.

Discuss!

2017-12 final decision: RelNotes() gives only last version and RelNotes(N) gives last N versions.

History

#1 Updated by John Abbott almost 7 years ago

A simple, backward-compatible solution would be to allow Relnotes to accept 0 or 1 args. With 0 args it prints out everything; with 1 arg it prints out (possibly) less.

In fact, I would almost prefer that RelNotes() with 0 args produce just the release notes for the current version of CoCoA-5, but this is not backward-compatible.

Assuming we do allow an arg, what should it be? And how should it influence what is printed?
e.g. it could be a version number, and prints out everything from that version onwards.

ALTERNATIVE there could be a new fn with different (but similar) name for handling the case of printing out just some of the relnotes.

#2 Updated by Anna Maria Bigatti almost 7 years ago

John Abbott wrote:

A simple, backward-compatible solution would be to allow Relnotes to accept 0 or 1 args. With 0 args it prints out everything; with 1 arg it prints out (possibly) less.

In fact, I would almost prefer that RelNotes() with 0 args produce just the release notes for the current version of CoCoA-5, but this is not backward-compatible.

In CoCoA-4 we produced only the last version notes.
Thinking that users probably do not install all versions, I modified it as is today.

I'll think about it.

#3 Updated by Anna Maria Bigatti over 6 years ago

  • Status changed from New to Feedback
  • Assignee set to Anna Maria Bigatti
  • % Done changed from 0 to 90
  • Estimated time set to 1.01 h

Done.
Documented

#4 Updated by Anna Maria Bigatti over 6 years ago

  • Description updated (diff)

#5 Updated by Anna Maria Bigatti over 6 years ago

  • Estimated time changed from 1.01 h to 1.51 h

#6 Updated by John Abbott over 6 years ago

  • Status changed from Feedback to Closed
  • % Done changed from 90 to 100

Also available in: Atom PDF