Issues and enhancement suggestions

[thorax58]

Love the application. Here are some issues/suggestion for you to consider:

1. Suggestion: Would be nice to copy text from the intrinsic display. For example if I search and expand the entry for __mm512_multishift_epi64_epi8 I'd like to be able to copy, for example, the perf information or the instruction name. However, the click is used to expand/collapse the entry so can't be used for copying text.
2. Issue: Searching by instruction doesn't work for me. If I enter "vperm" or "vpmulti", for example, I get a blank screen.
3. Issue: I have a firewall issue so I download the intrinsic/uops data the manually. I have to do this every time I go into the application as it won't use the existing data if the connect to download fails. Would be nice if after failing to connect it would just keep using the already local data.
4. Issue: Some Description texts don't wrap and are displayed in a single line making the last half unreadable. For example the Description text for _mm256_maskz_gf2p8affineinv_epi64_epi8 doesn't wrap.
5. Issue: The app losing focus causes the current open intrinsic to collapse/close. Would be nice to have the intrinsic visible while working in another window.
6. Suggestion: Perform the search as each character is typed rather than wait for . (Similar to what Intel's Intrinsic Guide does.) Would also be nice to ignore leading/trailing whitespace for the search.

Thanks again for a great app. Apologies if you get this twice.

[Sibras]

1. This is a limitiation of the UI library (Qt qml) which im not sure how to workaround it. There is a workaround inplace though that allows for copying the intrinsic name and header from the synopsis section (you should see the mouse cursor change when hovering over these items. I havnt yet worked out how to do it for the whole expandable section though.
2. Ill look into adding this
3. The program should create a file called 'dataCache' next to the executable that contains the cached contents of the download files. It should only try and redownload the source file if this cache file is missing or out of date. Check that this file is being created, it might be a write permission issue that is causing the file not to be saved between runs
4. Ill fix that
5. Just tested that and couldnt reproduce it. I tried changing windows, alt+tabbing out and the intrinsic stayed open. Any suggestion to reproduce?
6. This is actually a performance consideration as having it auto search on type was causing serious perforamnce issues due to the UI library being slower than expected. Ive since tried to workaround some perf issues to speed things up so Ill reevaluate whether auto search is feasible now

[thorax58]

Hi Matthew, A few comments below: 1. Didn't know about the subtle cursor difference over the copyable areas. Other main item to copy for me would be the instruction. Is it possible to make that a "copyable" item as well? Thanks. 2. Thought it was already there due to this excerpt from GitHub. Thanks - it would be a very useful feature. * [cid:40c1a36b-8a7c-4f34-87ad-3c532eb682b2] 3. I just checked on my machine that has no firewall. The files get downloaded every time and "dataCache" gets recreated, even if it is already there and there is no difference in the XML files. (The XML files get deleted after the cache is created.) Here's a theory: I'm in Canada, and I'm assuming you are in the US. We use a different date format. Is it possible that the difference in the date format is causing it to always think the files are out of date? 4. Great! 5. It's a little more complicated than I realized as I only see it after I've done a search. With the following steps I see the issue: * Open ShiftIntrinsicGuide but not full screen so you can access Desktop * Search for "multishift" * Click and expand the first item * Click anywhere on the Desktop and the item closes 1. If auto search is too slow to have on all the time, would it be possible to add a parameter to the command line to control whether auto search was enabled ("—auto-search"). The default could be disabled for compatibility. Thanks. Steve.

…

________________________________ From: Matthew Oliver ***@***.***> Sent: January 31, 2025 04:21 To: Sibras/ShiftIntrinsicGuide ***@***.***> Cc: thorax58 ***@***.***>; Author ***@***.***> Subject: Re: [Sibras/ShiftIntrinsicGuide] Issues and enhancement suggestions (Issue #2) 1. This is a limitiation of the UI library (Qt qml) which im not sure how to workaround it. There is a workaround inplace though that allows for copying the intrinsic name and header from the synopsis section (you should see the mouse cursor change when hovering over these items. I havnt yet worked out how to do it for the whole expandable section though. 2. Ill look into adding this 3. The program should create a file called 'dataCache' next to the executable that contains the cached contents of the download files. It should only try and redownload the source file if this cache file is missing or out of date. Check that this file is being created, it might be a write permission issue that is causing the file not to be saved between runs 4. Ill fix that 5. Just tested that and couldnt reproduce it. I tried changing windows, alt+tabbing out and the intrinsic stayed open. Any suggestion to reproduce? 6. This is actually a performance consideration as having it auto search on type was causing serious perforamnce issues due to the UI library being slower than expected. Ive since tried to workaround some perf issues to speed things up so Ill reevaluate whether auto search is feasible now — Reply to this email directly, view it on GitHub<#2 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/BOAQ73HFR2WWM55H6R6BYID2NM6ARAVCNFSM6AAAAABWBLE27GVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDMMRWG4ZTAOBWGM>. You are receiving this because you authored the thread.Message ID: ***@***.***>

[Sibras]

Ive added some commits that address some of the issues that you mention
Current status:

• (1) Ive added user selectable text into the expanded intrinsic area for the intruction (below the exiting selectable intrinsic/header)
• (2) WIP
• (3) Fixed this, it was a version issue with the upstream intel source being rather old
• (4) Should be fixed as ive added improved resizing both horizonatally and vertically
• (5) Ive added state to remember the 'expanded' state of each intrinsic which should fix it getting reset to collapsed
• (6) WIP

[thorax58]

Some feedback on 1.0.7 based on minimal testing: * Download issues are fixed on both firewalled and non-firewalled machines * Text wrap is fixed * Liking the instruction copy area * Space trimming before search looks good Issues * open intrinsic still closes upon losing focus so doesn't appear to be fixed. Using the example I gave you earlier still shows the problem * Version in lower right corner still says 1.0.6. Steve.

…

________________________________ From: Matthew Oliver ***@***.***> Sent: February 2, 2025 13:11 To: Sibras/ShiftIntrinsicGuide ***@***.***> Cc: thorax58 ***@***.***>; Author ***@***.***> Subject: Re: [Sibras/ShiftIntrinsicGuide] Issues and enhancement suggestions (Issue #2) Ive added some commits that address some of the issues that you mention Current status: [] 1. Ive added user selectable text into the expanded intrinsic area for the intruction (below the exiting selectable intrinsic/header) [ ] 2. WIP [] 3. Fixed this, it was a version issue with the upstream intel source being rather old. It now defaults to checking for updated data every 180 days even if the upstream is older than that [] 4. Should be fixed as ive added improved resizing both horizonatally and vertically [] 5. Ive added state to remember the 'expanded' state of each intrinsic which should fix it getting reset to collapsed [ ] 6. WIP — Reply to this email directly, view it on GitHub<#2 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/BOAQ73FZ5VRG7WNBQ44CMZT2NZNUBAVCNFSM6AAAAABWBLE27GVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDMMRZGQ4TQMRYGM>. You are receiving this because you authored the thread.