todo

Table of Contents

• 1 [[http://aegis.sourceforge.net/][Aegis]] stuff
  • 1.1 Stable release
    • 1.1.1 4.24
  • 1.2 Development Branch
    • 1.2.1 File UUID related issues (SF #1712779)
    • 1.2.2 aede file_action settings
    • 1.2.3 Interactive usage (SF #2049954)
    • 1.2.4 Change UUID as revision identifier
    • 1.2.5 Delta pinning
    • 1.2.6 Time-safe history (538, 539)
    • 1.2.7 Add dependency for aedist -rec
    • 1.2.8 Introduce file_action_rename
    • 1.2.9 change_id adoption
    • 1.2.10 Convert symtab_* functions to method
    • 1.2.11 Convert more functions to be methods
    • 1.2.12 Debugging allocation errors
    • 1.2.13 DocBook
    • 1.2.14 lib/en/html to be removed?
    • 1.2.15 One symtable per file-type
    • 1.2.16 fast-import
    • 1.2.17 For 4.26
• 2 [[http://progetti.arstecnica.it/tailor][Tailor]] related
  • 2.1 Aegis source back-end
    • 2.1.1 Fetch the inventory
    • 2.1.2 build the list of missing UUIDs
    • 2.1.3 For each UUID download the aedist archive
    • 2.1.4 Unpack the archive
    • 2.1.5 Apply the changes to the local sources

1 Aegis stuff

1.1 Stable release

1.1.1 4.24

• Remove aegis.cgi related stuff
  
  • DONE remove aegis.cgi.i
    
  • DONE notice the removal on aegis.cgi.1
    Update the man page to inform the user that the aegis.cgi script has been removed.
• TODO 4.24.2
  
  • VERIFY remove aegis.cgi references from aegis.spec*
    
  • TODO backport c524
    fixed a long-standing memory handling bug.
  • TODO investigate aem -gp problems (SF #2087900)
    Ask Brendan to check file's UUIDs.
  • TODO Check if C509 can be back-ported
    Before C509 can be back-ported more work has to be done to ensure that the default behavior assign the same UUID to files with the same name created in unrelated branches. Must be possible to override the default behavior to create files with the same name but different UUIDs.

1.2 Development Branch

1.2.1 File UUID related issues (SF #1712779)

UUID has been added to files to better handle various situations involving renames. From the rename POV it has been a success, however it created unexpected behavior in the users due to the transactional nature of Aegis.

• aenf locking issues
  Adding the file's UUID at aenf time will need to lock exclusivly the repository in order to avoid races (which part of the repository?). Evaluate performances degradation due to the exclusive lock.

1.2.2 aede file_action settings

When aede is executed for a change that is modifying for the first time a file in the branch, aede will add an entry to the branch fstate with (action = transparent, about_to_by_copied_by, locked_by). Then another change is integrated and the pfstate file inherits the content of the branch fstate file. When querying the repository about an integrated change the view path will use, if properly configured, the pfstate content, thus skipping that entry.

1.2.3 Interactive usage (SF #2049954)

• TODO check the interactive usage option
  

1.2.4 Change UUID as revision identifier

• TODO save the old edit_origin
  When integrating a grandparent merge the the edit_origin_new change's attribute contains the edit structure from the grand parent branch. It's value replace the edit_origin field in the branch. The old value is thrown away. We should save it as merge. We should save the version string since it's fast to retrieve the change it belongs to.
• TODO Use the merge field in the aedist archive
  Instead of using the roll_forward machinery use the newly introduced attribute. It should be faster.

1.2.5 Delta pinning

The aegis repository is organized as a tree where the leaves represents change-sets and the inner nodes are branches. The view_path feature that join the content of leaves and ancestor nodes to create a view of the entire code base is really handy, however it is difficult to insulate a branch from changes in an ancestor added after the branch creation. Such behavior is useful when doing maintenance-only activity on a branch.

1.2.6 Time-safe history (538, 539)

Aegis delegates the history function to external commands (rcs, fhist, aesvt, etc ...). Currently it is not possible to change the history tool in an easy/clean way, it is possible to hack something that may work however the best solution is to make the history query "module" time-safe. In order to achieve this target two more changes has to be implemented:

• TODO save the history_get_command
  the history_get_command must be saved as an user define change's attribute at integrate_pass time.
• DONE use the saved history_get_command
  use the saved history_get_command bound to change C1 to retrieve the file revisions created by C1.
• TODO aeimport vs. time-safe history
  the aeimport(1) command saves the history_get command as user-defined attribute. It is possible to import a project from RCS/CVS or SCCS and switch to a more modern history tool.

  It has to be noted that the history tool can be safely changeble only for projects created with aegis v.4.26 or later because aegis 4.26 introduced the ability to locate the change of a file edit in a reasonable time (whitout the need of the roll_forward machinery). Adding the usage of the roll_forward machinery make it possible to have a time-safe history even for projects created with a pre-4.26 release, however it may introduce memory and speed issues. For the moment such change is not implemented.

1.2.7 TODO Add dependency for aedist -rec

The aedist -rec command has been improved to handle change-set dependencies: aedist refuse to apply a change-set that has unresolved dependencies unless instructed by the user. The set of change-set identified by the edit-origin-UUID file's attribute forms the implicit dependencies. A user defined change's attribute (requires) forms the explicit dependencies.

1.2.8 Introduce file_action_rename

File renames are still modeled by a remove/create pair. A new file action should be introduced: file_action_rename.

1.2.9 change_id adoption

<gnus:[[gnus:nntp+news.gmane.org:gmane.comp.version-control.aegis.user>][Aegis Users mirror]] Update to use change_identifier:

• TODO aedist/send.cc
  
• TODO aefind/cmdline.y
  
• TODO aelcf/main.cc
  
• TODO aels/main.cc
  
• TODO aepromptcmd/main
  
• TODO aesub/main.cc
  
• TODO aetar/send.cc
  Update to use project_identifier:
• TODO aelpf/main.cc
  

1.2.10 TODO Convert symtab_* functions to method

1.2.11 Convert more functions to be methods

1.2.12 Debugging allocation errors

1.2.13 DocBook

• TODO Ask Ralph S. about his work on DocBook
  

1.2.14 TODO lib/en/html to be removed?

Ask Peter about html reports.

1.2.15 One symtable per file-type

1.2.16 fast-import

see http://repo.or.cz/w/git.git?a=blob;f=fast-import.c;h=e72b28679410155cb43968d315f02588e89fd5f1;hb=7f718e8b46b37a9e1caf58a372938817f04885d9 and http://www.kernel.org/pub/software/scm/git/docs/git-fast-import.html

1.2.17 For 4.26

• TODO remove remaining aegis.cgi references
  remove the aegis.cgi.1 man page

2 Tailor related

2.1 Aegis source back-end

It should work without having aegis installed. Works liked aedist -{replay,missing}

2.1.1 Fetch the inventory

2.1.2 build the list of missing UUIDs

The problem here is to map aegis change's ID (UUID) to identifiers in the target system.

2.1.3 For each UUID download the aedist archive

2.1.4 Unpack the archive

Need to parse the aegis meta-data to extract info. Can (ab)use the python tokenizer?

2.1.5 Apply the changes to the local sources

The aegis meta-data maps well to what tailor expects.

Author: Walter Franzini <walter.franzini-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>

Date: 2008/10/10 07:41:33 AM