Skip to content

FAQ

Jump to bottom
dpefour edited this page Sep 26, 2014 · 31 revisions

Frequently Asked Questions

  1. What is the licensing model for the Xilinx Tcl Store?

The Xilinx Tcl Store is under the Open Source BSD 2 license (BSD 2-Clause License ). The Tcl Store hosts some open source code developed and supported by the users.

Any user can copy and modify the files under the Tcl Store. To contribute to the Tcl Store, whether this is to submit a new app, to add a new proc an an existing app or to modify an exising code, the user must digitally sign the ./doc/legal.txt file under the applicable app directory. Without this digital signature, the gatekeepers cannot merge the code from the contributor to the Xilinx Tcl Store. The legal.txt file is digitally signed by adding a line at the end of the file with the date/GitHub ID/Full name. Only one digital signature per GitHub ID is required.

<YYYYMMDD Date>::<github id>::<Full Name>

Only the app owner's company name should appear on the first line of the file:

Copyright (c) 2014, <Company Name>
  1. Where can I find some Git tutorials?

Many Git and GitHub ressources and training can be found online. Some of those resources can be found on GitHub:

[Git and GitHub Ressources] (https://help.github.com/articles/what-are-other-good-resources-for-learning-git-and-github)

  1. How do I request permission to add a new script to an existing app?

To add a new script to an existing app, the contributor should get the permission from the App Owner. If the App Owner does not think that the script fit the app objectives, the contributor can also add the script to a different app or create a new app.

  1. How do I request the permission to add a new app?

The contributor should get permission to create a new app from the Xilinx Gate Keepers.

  1. How do I get permission to add a new company name to the repository?

The contributor should get the permission to create a new company name from the Xilinx Gate Keepers.

  1. Who are the Xilinx Gate Keepers?

The Gate Keepers are Greg Daughtry (daughtry@xilinx.com), David Pefourque (dpefour@xilinx.com) and Raj Klair (rvklair@xilinx.com).

  1. Who are the app owners?
App Name Company/User Owner
designUtils Xilinx David Pefourque (dpefour@xilinx.com)
diff Xilinx Nik Cimino (nikc@xilinx.com)
projUtils Xilinx Raj Klair (rvklair@xilinx.com)
xsim Xilinx Raj Klair (rvklair@xilinx.com)
modelsim Xilinx Raj Klair (rvklair@xilinx.com)
ies Xilinx Raj Klair (rvklair@xilinx.com)
vcs Xilinx Raj Klair (rvklair@xilinx.com)
tk_tunnel Xilinx Nik Cimino (nikc@xilinx.com)
junit Xilinx Nik Cimino (nikc@xilinx.com)
myapp mycompany David Pefourque (dpefour@xilinx.com)
template mycompany David Pefourque (dpefour@xilinx.com)

Each app has one owner. You need owner permission to be able to add a script to an existing app. This is normally done by issuing a pull request to the owners master branch of the rep - and they will merge and gate the changes.

  1. Who do I contact for a bug report or an enhancement request?

For any bug report for an app, please file an issue on GitHub.com with the details. For enhancement requests contact the owner of the script or the App Owner. If you already have contribution (pull) access for the app - you can also issue a pull request from git. For infrastructure enhancements, please contact tclstore@xilinx.com.

  1. Do apps have versions? How does it work?

Yes. Click Here for Version Explanation

  1. How does this stuff work under the hood?

Click Here for some background on underlying mechanisms

  1. git push hangs and return error: RPC failed; result=56, HTTP code = 0

For example:

%> git push origin master
Counting objects: 403, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (152/152), done.
error: RPC failed; result=56, HTTP code = 0
...

Try to increase the HTTP/HTTPS buffer size:

%> git config --global http.postBuffer 524288000
%> git config --global https.postBuffer 524288000
  1. The catalog refresh under Windows does not seem to work

Some Windows plateforms seem to require more time to connect to GIT and refresh the catalog. It is possible to increase the timeout amount through the following parameter:

set_param tclapp.gitTimeOut <timeout_in_seconds>
# For example:
set_param tclapp.gitTimeOut 25
# Or
set_param tclapp.gitTimeOut 50
# Or more if necessary
  1. How to delete the forked repository under GitHub?

The forked repository can be deleted under GitHub through the Settings page. You will need to browse your forked repository and the link to the Settings will be on the right hand side. The button to delete the repository is located at the very bottom of the settings page.

Note: Once you forked repository has been deleted, you can go back to the Xilinx Tcl Store repository and re-fork the repository.

  1. GitHub does not seem to work properly. How can I check the status of GitHub?

It can happen that GitHub experiences some technical issues. The status of GitHub can be checked on this page.

Clone this wiki locally